Boost logo

Boost :

From: Julio M. Merino Vidal (jmmv84_at_[hidden])
Date: 2007-04-05 03:33:24

On 05/04/2007, at 0:26, Eric Niebler wrote:

> Moving to boost-docs ...

Ah, didn't notice that mailing list. Will send future patches to
BoostBook (QuickBook too?) to that list.

> Julio M. Merino Vidal wrote:
>> Hello,
>> I'm currently having trouble with the conversion between the XML
>> generated by Doxygen and the Boostbook code generated by
>> doxygen2boostbook.xsl.
> <snip>
>> The attached patch resolves these issues for me, but I'm not sure
>> it is
>> correct. Specially, the new sectiondef template in toplevel mode is
>> needed to avoid the duplicates in the #defines' synopsis... but maybe
>> it'd be avoided in some other way.
>> Feel free to modify it to correct any obvious mistake, but please
>> resolve the conversion issue :-)
> Thanks!

What about the patch attached now? It removes the handling of
duplicate functions/macros/whatever overall, which surely was
incomplete and was only working-around a bug in Doxygen. With 1.5.2,
this is not needed any more and removes some magic from the stylesheet.

>> PS: Is this Doxygen->Boostbook conversion experimental? Support for
>> several things seem to be missing...
> It sure seems experimental, doesn't it? The biggest thing missing is
> someone who is skilled at XSLT and has the motivation to fix the bugs
> and add the missing features. I'll gladly apply as many patches as you
> care to submit.

I see. I don't know much yet about the XML generated by Doxygen, but
at a first look the conversion XSLT seemed overly complicated. But
well, maybe that conversion is really needed.

> And while you're at it, can you fix the bugs in Doxygen, too? ;-)

In fact, I was going to take a look at the duplicates issue, but it
looks like someone beat me to it ;-)


Julio M. Merino Vidal <jmmv84_at_[hidden]>

Boost list run by bdawes at, gregod at, cpdaniel at, john at