gdoc replacement

[Andrew W. Nosenko]

On Tue, May 12, 2009 at 10:05 PM, Nikos Mavrogiannopoulos
<nmav at gnutls.org> wrote:
> Simon Josefsson wrote:
>> Hi Martin.  I had finally time to look into this, and I believe I have
>> solved it in git master.  You can depend on the order things are
>> substituted: they seems to be done in ASCII order.  Your initial patch
>> seems to be the correct thing.  However, it changed the order of how the
>> substitutions were applied.  So rather than working around that problem
>> using your patch (which caused other problems) I modified your initial
>> regexp so that it does the same thing but is applied later.
>>
>> I really prefer to stop messing with the gdoc script.  It should be
>> rewritten cleanly and added to gnulib.  Before doing that, it begs the
>> question why we don't abandon the GTK-DOC style and use the doxygen
>> format instead, which probably has conversion tools already.  I'm not
>> sure what the answer is.  I think the GTK-DOC HTML manual and
>> integration into the GNOME environment is a good thing.  But maybe that
>> can be achieved via doxygen anyway, through a conversion script?
>> Changing to doxygen instead of gtk-doc will require source-code changes,
>> too.
>> What do people generally think of GTK-DOC vs Doxygen?
>
> I used doxygen some time after I messed up with gdoc and I liked the
> output. The only reason I didn't port gnutls to it was lack of time :)
>

The most important disadvantage of doxygen, from my personal point of
view, and the main reason why I stoped to use it is its inability to
integrate with devhelp.

-- 
Andrew W. Nosenko <andrew.w.nosenko at gmail.com>