Re: Boost.Python docs update

On 12/08/15 04:41 AM, Daniel James wrote:
> On 12 August 2015 at 09:09, Stefan Seefeld <[email protected]> wrote:
>> On 11/08/15 07:16 PM, Daniel James wrote:
>>> I had a quick try at building it, and it failed because
>>> 'boost.defaults' gets set twice.
>> Where does it get set the other time ? I only set it once, and I don't
>> understand what may differ between your setup and mine, i.e. why I don't
>> see this error.
> It's set in Jamroot at the root of the super project. Libraries aren't
> really meant to use this parameter. I tried to create better build
> support, but couldn't without making Jamroot dependant on the
> boostbook jamfile.


Ah, that explains it: I'm using a modified build system as I usually
build boost.python stand-alone.

>
>> Is the process you follow to regenerate
>> http://www.boost.org/doc/libs/develop/ documented anywhere ? It would be
>> useful if I could try myself, so I can reproduce the issue(s) you are
>> seeing and fix it without having to for forth and back...
> I was just running 'b2' from libs/python/doc. When I tried it,
> everything other than python was on the master branch, but that
> shouldn't make a difference. I guess you might be using a different
> version of xsltproc which doesn't complain about duplicate parameters.


No, rebuilding from within a full boost tree shows the same error. I
tried adding "-<xsl:param>..." but that resulted in the error

Konsole output
error: "html:-<xsl:param>boost.defaults=none" is not a known value of
feature <format>
error: legal values: "html" "xhtml" "htmlhelp" "onehtml" "man" "pdf"
"ps" "docbook" "fo" "tests"


my full modified Jamfile is attached. Any idea what I'm doing wrong ?
Where should I add the "subtracted parameter" ?

Thanks,
    Stefan

-- 

      ...ich hab' noch einen Koffer in Berlin...

_______________________________________________
Boost-docs mailing list
[email protected]
http://lists.boost.org/mailman/listinfo.cgi/boost-docs

# Copyright (c) 2006 Joel de Guzman
# Copyright (c) 2015 Stefan Seefeld
#
# Distributed under the Boost Software License, Version 1.0. (See accompanying
# file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

path-constant here : . ;
path-constant images : html/images ;


project python/doc
    : requirements
      <format>html:-<xsl:param>boost.defaults=none
      <format>html:<xsl:param>boost.defaults=none
      <format>html:<xsl:param>toc.max.depth=3
      <format>html:<xsl:param>toc.section.depth=2
      <format>html:<xsl:param>chunk.section.depth=1
    ;

import boostbook ;
import quickbook ;
import docutils ;

boostbook python : python.qbk
	  : <format>html:<name>$(here)/html
	    <format>html:<xsl:param>generate.toc="library nop; chapter toc; section toc;"
            <format>html:<xsl:param>html.stylesheet=boostbook.css
            <format>html:<xsl:param>boost.image.src=images/boost.png
            <format>html:<xsl:param>boost.graphics.root=images/
	    ;

boostbook tutorial : tutorial.qbk
	  : <format>html:<name>$(here)/html/tutorial
	    <format>html:<xsl:param>html.stylesheet=../boostbook.css
            <format>html:<xsl:param>boost.image.src=../images/boost.png
            <format>html:<xsl:param>boost.graphics.root=../images/
	    ;

boostbook reference : reference.qbk
	  : <format>html:<name>$(here)/html/reference
	    <format>html:<xsl:param>html.stylesheet=../boostbook.css
            <format>html:<xsl:param>boost.image.src=../images/boost.png
            <format>html:<xsl:param>boost.graphics.root=../images/
	    ;

html article : article.rst
         : <location>html
	   <docutils-html>"--link-stylesheet --traceback --trim-footnote-reference-space --footnote-references=superscript --stylesheet=rst.css"
            ;