[Boost-docs] [Quickbook and Boostbook, Boost.Build] some problems on using quickbook and boostbook

Subject: [Boost-docs] [Quickbook and Boostbook, Boost.Build] some problems on using quickbook and boostbook
From: weining hao (weininghao_at_[hidden])
Date: 2009-07-17 20:48:49

Hi,

I am working with Suse 10 and using the Quickbook and Boostbook to generate HTML and pdf documentation.  I've got good documents with boost_1.33.1.

Now I want to construct a project which only includes necessary stuff for making documentation. I downloaded boost-build-2.0-m10, (since boost_1.33.1 contains it.) copied quickbook(.exe) to usr/local/bin, and set the path of quickbook and boostbook in user-config.jam according to the guide of http://www.boost.org/doc/libs/1_39_0/doc/html/quickbook/install.html#quickbook.install.linux
Now my project docs looks like:

--docs/
    --build-system/
    --html/
    --src/
        --measkern.qbk
    --boost-build.jam
    --Jamroot

Where
1) build-system/ is actually the  boost-build-2.0-m10;
2) html/ is for generating HTML documentation;
3) boost-build.jam contains one statement as:
             boost-build build-system ;
4) Jamroot file looks like:
          using quickbook ;
          import boostbook : boostbook ;
          boostbook mk : src/measkern.qbk ;
5) and without the commented lines, the build-system/user-config.jam is configured as:
        import toolset : using ;
        #  Configure gcc (default version)
        using gcc ;
        # Python configuration
        using python : 2.4 : /usr ;
        # BoostBook configuration
       using boostbook
          : /usr/share/xml/docbook/stzlesheet/nwalsh
          : /usr/share/xml/docbook/schema/dtd/4.2
          ;
       using quickbook
         : /usr/local/bin/quickbook
         ;
        using xsltproc : /usr/bin/xsltproc ;
        using doxygen : /usr/bin/doxygen ;
        using fop : /usr/share/fop-0.20.5/fop.sh : : /usr ;

After running bjam --v2 , I got 

python.jam: No such file or directory
/home/measkern2/docs/build-system/build/toolset.jam:29: in using
rule python.init unknown in module toolset.
/home/measkern2/docs/build-system/user-config.jam:56: in modules.load
/home/measkern2/docs/build-system/build-system.jam:61: in load
/home/measkern2/docs/build-system/kernel/modules.jam:259: in import
/home/measkern2/docs/build-system/kernel/bootstrap.jam:120: in boost-build
/home/measkern2/docs/boost-build.jam:1: in module scope

There is the file python at usr/bin/. And even after modifying the path of python as 
    using python : 2.4 : /usr/bin ;
, same error occurs.

My questions are:
1) Is there something wrong in my project leading to the above error?
2) I have to download the Boost-build package for generating documentation, even Suse 10 has some pre-install Boost packages: boost, boost-devel, boost-doc, boost-jam. Am I right?
3) If I am only interested in Quickbook and Boostbook, and for building the above project, is boost-build-2.0-m10 enough, or it's better to follow the boost-build-2.0-m12 or even higher version in the future? 
    If I use the boost-build-2.0-m12, does that mean I need to download the new Boost version (e.g. boost-1.39.0 which includes boost-build-2.0-m12) and generate new quickbook(.exe) to match the new build system? 
    In that case, something should also be done with the Boostbook configuration?

It's very appreciated that you read the mail and give me feedback.

Best regards,
wn 

_________________________________________________________________
Show them the way! Add maps and directions to your party invites. 
http://www.microsoft.com/windows/windowslive/products/events.aspx