Re: [boost] [boostbook] Duplicates and free functions

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 ;-)

Cheers,

-- 
Julio M. Merino Vidal <jmmv84_at_[hidden]>