Re: [boost] Writing documentation

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:
>>>
>>> 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?
>
>
Yes I did.

  $ dpkg --get-selections | grep -e docbook -e xsltproc
  docbook        install
  docbook-xml    install
  docbook-xsl    install
  xsltproc       install

I don't have doxygen though. Could that be the problem?

- Borislav