"Matias Capeletto" <matias.capeletto@gmail.com> wrote in message news:e9b043a10706251415s483a5189yc2ea30625254d52f@mail.gmail.com...
On 6/25/07, Stefan Seefeld <seefeld@sympatico.ca> wrote:
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.
I stand corrected. Just wanted to point out what we need. Your solution is far more flexible.
libs/{lib_name}/doc/{lib_name}.xml libs/{lib_name}/doc/{lib_name}.xsl
Nope. <output>.xsl is more flexible Gennadiy