Boost logo

Boost :

Subject: Re: [boost] Writing documentation
From: Andrey Semashev (andrey.semashev_at_[hidden])
Date: 2013-02-02 11:33:27


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:
> >
> > 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?

I'm not sure. Did you also install xsltproc and docbook packages as described
in the installation guide?


Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk