Re: [Boost-docs] building docs for one library

Subject: Re: [Boost-docs] building docs for one library
From: Robert Ramey (ramey_at_[hidden])
Date: 2009-04-11 21:00:05

Here is what th Jamfile.v2 looks like:

import doxygen ;
import quickbook ;

doxygen autodoc
    :
 [ glob ../../../boost/coroutine/*.hpp ]
    :
  <doxygen:param>EXTRACT_ALL=YES
        <doxygen:param>"PREDEFINED=\"BOOST_COROUTINE_DEDUCED_TYPENAME_DEFAULT=typename\" 
\\
                                   \"BOOST_DEDUCED_TYPENAME=typename\""
        <doxygen:param>HIDE_UNDOC_MEMBERS=NO
        <doxygen:param>EXTRACT_PRIVATE=NO
        <doxygen:param>ENABLE_PREPROCESSING=YES
        <doxygen:param>MACRO_EXPANSION=YES
        <doxygen:param>EXPAND_ONLY_PREDEF=YES
        <doxygen:param>SEARCH_INCLUDES=YES
        <doxygen:param>INCLUDE_PATH=$(BOOST_ROOT)
    ;

xml coroutine
    :
        coroutine.qbk
    ;

boostbook standalone
    :
        coroutine
    :
        <xsl:param>toc.max.depth=3
        <xsl:param>toc.section.depth=3
        <xsl:param>chunk.section.depth=3
    ;

Robert Ramey
Steven Watanabe wrote:
> AMDG
>
> Robert Ramey wrote:
>> I've patched in the coroutine library into my boost 1.37 tree and
>> want to build the documenation
>> for it.  When I invoke bjam either from within the directory
>> containing the files for from the
>> boost root I get a series of messages back that i don't understand -
>> see below.
>>
>> What is the proper way to invoke the documentation build for one
>> library? Robert Ramey
>>
>> $ pwd
>> C:/boost_1_37_0/libs/coroutine/doc
>> $ ls
>> Jamfile.v2     coroutine.qbk  index.html     index_files
>>
>> $ bjam
>> Jamfile.v2:36: in modules.load
>> rule doxygen unknown in module
>> Jamfile</C:/boost_1_37_0/libs/coroutine/doc>.
>> C:/boost_1_37_0/tools/build/v2/build\project.jam:307: in
>> load-jamfile C:/boost_1_37_0/tools/build/v2/build\project.jam:62: in
>> load C:/boost_1_37_0/tools/build/v2/build\project.jam:168: in
>> project.find C:/boost_1_37_0/tools/build/v2\build-system.jam:535: in
>> load C:\boost_1_37_0\tools\build\v2/kernel\modules.jam:283: in
>> import C:\boost_1_37_0\tools\build\v2/kernel/bootstrap.jam:128: in
>> boost-build C:\boost_1_37_0\boost-build.jam:16: in module scop
>
> The Jamfile for libs/coroutine/doc seems to be missing an
> import doxygen ;
>
> In Christ,
> Steven Watanabe