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

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

Hi,

the original question sheet is at http://lists.boost.org/MailArchives/boost-docs/2009/07/3864.php.

> I believe that whatever you have at /home/measkern2/docs/build-system/ does not
> have tools/python.jam
> 
You're right. But why isn't it included in the boost-build-2.0-m10?
I copy the file from boost-build-2.0-m12/tools and run bjam --v2, some error occurs:

/home/measkern2/docs/build-system/build/type.jam:54: in type.register from module type
error: Type PYTHON_EXTENSION is already registered.
/home/measkern2/docs/build-system/tools/python.jam:959: in load from module python
/home/measkern2/docs/build-system/kernel/modules.jam:259: in import from module modules
/home/measkern2/docs/build-system/build/toolset.jam:25: in using from module toolset
/home/measkern2/docs/build-system/user-config.jam:56: in modules.load from module user-config
/home/measkern2/docs/build-system/build-system.jam:61: in load from module build-system
/home/measkern2/docs/build-system/kernel/modules.jam:259: in import from module modules
/home/measkern2/docs/build-system/kernel/bootstrap.jam:120: in boost-build from module
/home/measkern2/docs/boost-build.jam:1: in module scope from module

What does the error mean?

 
> > 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?
> 
> It is always best to use either SVN HEAD version of Boost.Build or the nightly build. Failing
> that, the version from Boost 1.39 release.

okay. I download the  boost-build-2.0-m12 and unpacked it into build-system_12. A project with the same structure and similar files with the above one is constructed. After running bjam --v2, I get:

/home/measkern2/docs_12/build-system_12/tools/boostbook.jam:120: in boostbook.init from module boostbook
warning: couldn't find BoostBook xsl or dtd directories;
warning: please set "BOOST_ROOT" variable to the root directory of your boost installation. Searched in:
warning: tools/boostbook
/home/measkern2/docs_12/build-system_12/../../boostbook
/home/measkern2/docs_12/build-system_12/build/toolset.jam:36: in using from module toolset
/home/measkern2/docs_12/build-system_12/user-config.jam:61: in modules.load from module user-config
/home/measkern2/docs_12/build-system_12/build-system.jam:104: in load-config from module build-system
/home/measkern2/docs_12/build-system_12/build-system.jam:154: in load from module build-system
/home/measkern2/docs_12/build-system_12/kernel/modules.jam:261: in import from module modules
/home/measkern2/docs_12/build-system_12/kernel/bootstrap.jam:132: in boost-build from module
/home/measkern2/docs_12/boost-build.jam:1: in module scope from module
/home/measkern2/docs_12/build-system_12/tools/boostbook.jam:214: in boostbook.generate-xml-catalog
*** argument error
* rule regex.replace ( string match replacement )
* called with: (   %20 )
* missing argument replacement
/home/measkern2/docs_12/build-system_12/util/regex.jam:111:see definition of rule 'replace' being called
/home/measkern2/docs_12/build-system_12/kernel/modules.jam:66: in modules.call-in
/home/measkern2/docs_12/build-system_12/util/indirect.jam:82: in indirect.call
/home/measkern2/docs_12/build-system_12/build/virtual-target.jam:720: in object(action)@94.actualize
/home/measkern2/docs_12/build-system_12/build/virtual-target.jam:274: in actualize-action
/home/measkern2/docs_12/build-system_12/build/virtual-target.jam:467: in actualize-no-scanner
/home/measkern2/docs_12/build-system_12/build/virtual-target.jam:111: in object(file-target)@95.actualize
/home/measkern2/docs_12/build-system_12/build/virtual-target.jam:463: in actualize-no-scanner
/home/measkern2/docs_12/build-system_12/build/virtual-target.jam:111: in object(file-target)@110.actualize
/home/measkern2/docs_12/build-system_12/build-system.jam:488: in load
/home/measkern2/docs_12/build-system_12/kernel/modules.jam:261: in import
/home/measkern2/docs_12/build-system_12/kernel/bootstrap.jam:132: in boost-build
/home/measkern2/docs_12/boost-build.jam:1: in module scope

I cannot see where the error is, but indeed that there is no generated HTML or pdf file. What's the wrong with it?

> >     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?
> 
> I do not thing that anything of that is required, unless you want to take advantage of new
> features or fixes in quickbook or the rest of documentation tools.
> 
I mean do the old quickbook and the new build system match each other?

Best regards,
wn

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