Re: [boost] Boost documentation format (was Re: Boost documentation)

From: Gennadiy Rozental (gennadiy.rozental_at_[hidden])
Date: 2007-06-25 17:17:02

"Matias Capeletto" <matias.capeletto_at_[hidden]> wrote in message 
news:e9b043a10706251404s599262cw309916b3dedc1633_at_mail.gmail.com...
> On 6/25/07, Gennadiy Rozental <gennadiy.rozental_at_[hidden]> wrote:
>>
>> "Douglas Gregor" <dgregor_at_[hidden]> wrote in message
>> news:468025D2.4050102_at_osl.iu.edu...
>> > Gennadiy Rozental wrote:
>> > The DocBook or BoostBook XML will be generated via Quickbook when
>> > needed. Or do you want the DocBook/BoostBook XML to always be in the
>> > source tree, even if it can be regenerated?
>>
>> Yes. Essentially  I should be able to generate docs for any library and 
>> know
>> nothing about quickbook and it's tools whatsoever. And how you make this
>> file - you own business.
>
> I agree with Gennady.
> It is better for now to separate quickbook from dockbook.
>
> We may ask authors to provide:
>
> libs/{lib_name}/doc/{lib_name}.xml
> libs/{lib_name}/doc/--stringparam
>
> I like .xml over .docbook but I have no strong opinions about this.
> The --stringparam contains parameters that affects the chunker, that
> have to be library independent.

I would prefer developers wishing to twick output parameters for any output 
to generate <output>.xsl in corresponding doc directory.

Gennadiy