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?