[Boost-docs] Running boost book

Subject: [Boost-docs] Running boost book
From: Robert Ramey (ramey_at_[hidden])
Date: 2011-06-25 00:45:46

John Maddock wrote:
>> Once BoostBook has been configured, we can build some documentation.
>> First, change to the directory $BOOST_ROOT/doc and remove (or make
>> writable) the .html files in $BOOST_ROOT/doc/html. Then, run bjam to
>> build HTML documentation. You should see several warnings like these
>> while DocBook documentation is being built from BoostBook
>> documentation: Which begs the question of how one can do this for 
>> anything that is
>> not inserted to the boostbuild tree.  How do I go about building
>> documentation with boost tools for a project which is not inside the
>> boost tree?
>
> Eh?  Just do it!  Assuming you have a Jamfile, just invoke bjam.  All
> it needs is BOOST_BUILD_PATH setting so that Boost.Build can find
> it's files.
> Also take a look at how sandbox/tools/auto_index is set up, as this
> provides a simpl-ish example of what you want to do.
>
> John.

OK - I've dropped back to punt.

I've carefully followed the instructions in 
http://boost-sandbox.sourceforge.net/doc/html/boostbook/getting/started.html 
and tried to run the suggested test of building the documenation for boost 
function.

The documentation instructs one to add the following to his user-config.jam 
file

#  BoostBook configuration
using boostbook
  : DOCBOOK_XSL_DIR
  : DOCBOOK_DTD_DIR
  ;
which didn't work for me so I used
#  BoostBook configuration
using boostbook
  : "c:/docbook/xsl"
  : "c:/docbook/dtd"  ;

When I run bjam from within the boost/libs/function/doc directory i get
$ ls c:/docbook
dtd  xsl
$ whereis xsltproc
C:\Program Files\xsltproc/xsltproc.exe
$ xsltproc -V
Using libxml 20614CVS2195, libxslt 10111CVS955 and libexslt 809CVS955
xsltproc was compiled against libxml 20614, libxslt 10111 and libexslt 809
libxslt 10111 was compiled against libxml 20614
libexslt 809 was compiled against libxml 20614
$
$ bjam
warning: No toolsets are configured.
warning: Configuring default toolset "msvc".
warning: If the default is wrong, your build may not work correctly.
warning: Use the "toolset=xxxxx" option to override our guess.
warning: For more configuration options, please consult
warning: 
http://boost.org/boost-build2/doc/html/bbv2/advanced/configuration.html

...found 23 targets...
...updating 2 targets...
xslt-xsltproc.windows 
..\..\..\bin.v2\libs\function\doc\msvc-9.0\debug\function.
docbook
runtime error
unregistered variable uppercase-letters
xmlXPathCompOpEval: parameter error
runtime error
unregistered variable uppercase-letters
xmlXPathCompOpEval: parameter error
runtime error
unregistered variable uppercase-letters
xmlXPathCompOpEval: parameter error
runtime error
unregistered variable uppercase-letters
xmlXPathCompOpEval: parameter error
runtime error
unregistered variable uppercase-letters
xmlXPathCompOpEval: parameter error
runtime error

Anyone care make a suggestion?

Robert Ramey