Re: [boost] Writing documentation

Subject: Re: [boost] Writing documentation
From: Borislav Stanimirov (b.stanimirov_at_[hidden])
Date: 2013-02-02 11:08:19

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:
>
> http://www.boost.org/doc/libs/release/doc/html/quickbook.html
>
>

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?

-- Borislav