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

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

"Stefan Seefeld" <seefeld_at_[hidden]> wrote in message 
news:46802F38.7060307_at_sympatico.ca...
> Matias Capeletto wrote:
>
>> 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.
>
> Chunking is a styling issue, and thus shouldn't be part of the sources.
> And, if you really want library authors to be able to customize the 
> process,
> I think it would  be better to allow for them to provide a custom xsl 
> stylesheet
> (that presumably imports the global boost stylesheet). '--stringparam' is
> not flexible enough, and specific to xsltproc.

Hear, hear

Gennadiy