Subject: Re: [boost] Writing documentation
From: Borislav Stanimirov (b.stanimirov_at_[hidden])
Date: 2013-02-02 11:43:42
On 02/02/2013 06:33 PM, Andrey Semashev wrote:
> On Saturday 02 February 2013 18:08:19 Borislav Stanimirov wrote:
>> On 02/02/2013 12:00 PM, Andrey Semashev wrote:
>>> On Saturday 02 February 2013 11:46:19 Borislav Stanimirov wrote:
>>>> I was wondering how one writes documentation.
>>> I found QuickBook to be the easiest tool for documenting Boost libraries.
>>> You can find its docs on the site:
>> Hi again,
>> Perhaps you could help me a bit more?
>> I tried creating a Jamfile.v2 for my book. Here it is:
>> using quickbook ;
>> xml mixin_doc : mixin.qbk ;
>> boostbook mixin : mixin_doc ;
>> install html ;
>> It successfully generateates mixin_doc.xml but doesn't generate any
>> html. Here's the output:
>> warn: Unable to construct ./mixin
>> ...found 7 targets...
>> ...updating 4 targets...
>> common.mkdir bin
>> common.mkdir bin/gcc-4.6
>> common.mkdir bin/gcc-4.6/debug
>> quickbook.quickbook-to-boostbook bin/gcc-4.6/debug/mixin_doc.xml
>> Generating Output File: bin/gcc-4.6/debug/mixin_doc.xml
>> ...updated 4 targets...
>> Am I missing something?
> I'm not sure. Did you also install xsltproc and docbook packages as described
> in the installation guide?
Yes I did.
$ dpkg --get-selections | grep -e docbook -e xsltproc
I don't have doxygen though. Could that be the problem?
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk