"Matias Capeletto" <matias.capeletto@gmail.com> wrote in message news:e9b043a10706251404s599262cw309916b3dedc1633@mail.gmail.com...
On 6/25/07, Gennadiy Rozental <gennadiy.rozental@thomson.com> wrote:
"Douglas Gregor" <dgregor@osl.iu.edu> wrote in message news:468025D2.4050102@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