Re: [Boost-users] Quickbook quick start

Subject: Re: [Boost-users] Quickbook quick start
From: Deane Yang (deane.yang_at_[hidden])
Date: 2009-05-04 09:25:16

Deane Yang wrote:
> tom fogal wrote:
>> Peng Yu <PengYu.UT_at_[hidden]> writes:
>>> I wan to use Quickbook to generate documentation for my code to be
>>> submit to boost. I understand that Quickbook could help make the code
>>> and the documentation consistent. But there is no a tutorial webpage
>>> that describes how I can get started with Quickbook.
>>
>> Getting started:
>>
>>   http://www.boost.org/doc/libs/1_39_0/doc/html/quickbook/install.html
>>
>> Documenting:
>>
>>   http://www.boost.org/doc/libs/1_39_0/doc/html/quickbook/syntax.html
>>
>> Cheers,
>>
>> -tom
> 
> Hi,
> 
> I just followed the instructions for Windows. Then I went to boost/doc 
> and ran "bjam". It appears that doxygen is required, no? Shouldn't 
> installation instructions for doxygen be included in the Windows 
> section? There seem to be such instructions in the MacOS X section.
> 
> Deane

A followup: I installed doxygen and added

using doxygen ;

to my user-config.jam file. This did not work. I tried replacing the 
line above by:

using doxygen : <absolute path to doxygen.exe> ;

This also did not work. I get the following error message below. Any 
advice or help would be welcome.

warn: Unable to construct ../libs/asio/doc/asio
c:\home\deane\git\software\boost\libs\accumulators\doc\Jamfile.v2:18: in 
modules.load
rule doxygen unknown in module 
Jamfile</c:/home/deane/git/software/boost/libs/accumulators/doc>.
c:/home/deane/git/software/boost/tools/build/v2/build\project.jam:307: 
in load-jamfile
c:/home/deane/git/software/boost/tools/build/v2/build\project.jam:62: in 
load
c:/home/deane/git/software/boost/tools/build/v2/build\project.jam:168: 
in project.find
c:/home/deane/git/software/boost/tools/build/v2/build\targets.jam:361: 
in find-really
c:/home/deane/git/software/boost/tools/build/v2/build\targets.jam:427: 
in object(project-target)@376.find
c:/home/deane/git/software/boost/tools/build/v2/build\targets.jam:851: 
in resolve-reference
c:/home/deane/git/software/boost/tools/build/v2/build\targets.jam:868: 
in targets.generate-from-reference
c:/home/deane/git/software/boost/tools/build/v2/build\targets.jam:1168: 
in generate-dependencies
c:/home/deane/git/software/boost/tools/build/v2/build\targets.jam:1216: 
in object(typed-target)@383.generate
c:/home/deane/git/software/boost/tools/build/v2/build\targets.jam:767: 
in generate-really
c:/home/deane/git/software/boost/tools/build/v2/build\targets.jam:739: 
in object(main-target)@397.generate
c:/home/deane/git/software/boost/tools/build/v2/build\targets.jam:257: 
in object(project-target)@376.generate
c:/home/deane/git/software/boost/tools/build/v2\build-system.jam:682: in 
load
c:\home\deane\git\software\boost\tools\build\v2/kernel\modules.jam:283: 
in import
c:\home\deane\git\software\boost\tools\build\v2\kernel\bootstrap.jam:128: 
in boost-build
c:\home\deane\git\software\boost\boost-build.jam:16: in module scope