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:
>> I'm currently having trouble with the conversion between the XML
>> generated by Doxygen and the Boostbook code generated by
>> 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 :-)
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 acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk