Re: [Boost-build] [boostbook] Building Boost documentation

From: Vladimir Prus (ghost_at_[hidden])
Date: 2007-11-18 08:52:04

Edward Diener wrote:

> Because I wanted to read documentation on some of the new libraries in
> the latest Boost SVN repository, which existed only in XML format, it
> was time to go through the annual rite of attempting to use Doug
> Gregor's excellent documention of "The Boostbook Documentation Format"
> in order to setup the documentation system to generate documentation
> using bjam. Although Mr. Gregor's documentation is extremely good, I
> have never been completely successful in the past, but I had my fingers
> crossed in hopeful expectation this time. I am doing this on Windows so
> I have to set things up manually.
> 
> 1) I downloaded xsltproc and doxygen successfully, and "installed" them
> into appropriate directories and, to make things easy for myself, put
> those directories in my PATH.
> 
> 2) After making sure I had no .jam file of any kind in my home directory
> I went to the \tools\build\v2\user-config,jam in the directory in which
> the latest  Boost Subversion resides, and added the line:
> 
> using xsltproc ;
> 
> 3) I downloaded the latest XSL stylesheets and Docbook DTD and put them
> in their own separate directies, "E:\Utilities\docbook-xsl-1.73.2" and
> "E:\Utilities\docbook-dtd-4.2".
> 
> 4) I added to my user-config.jam the lines:
> 
> #  BoostBook configuration
> using boostbook
>      : E:/Utilities/docbook-xsl-1.73.2
>      : E:/Utilities/docbook-dtd-4.2
>      ;
> 
> 5) Now further following instructions to test out my installation so far
> I went to the \libs\function\doc after copying boostbook.css from the
> \doc\html directory, and tried the bjam command. My result is:
> 
> "warning: Graph library does not contain optional GraphML reader.
> note: to enable GraphML support, set EXPAT_INCLUDE and EXPAT_LIBPATH to
> the note: directories containing the Expat headers and libraries,
> respectively. warning: skipping optional Message Passing Interface (MPI)
> library. note: to enable MPI support, add "using mpi ;" to
> user-config.jam. note: to suppress this message, pass "--without-mpi" to
> bjam. note: otherwise, you can safely ignore this message.
> Building Boost.Regex with the optional Unicode/ICU support disabled.
> Please refer to the Boost.Regex documentation for more information
> (don't panic: this is a strictly optional feature).
> E:/Utilities/BoostLibraries/boost_1_34_0/tools/build/v2/tools\boostbook.jam:300:
>     in object(boostbook-generator)@326.run
> warning: rulename $(base-target).depends expands to empty string

1. Add --debug-generators option to bjam and send the the output.
2. Try adding

        using doxygen ;

to user-config.jam

Thanks,
Volodya