gdoc replacement

Andrew W. Nosenko andrew.w.nosenko at
Wed May 13 11:13:52 CEST 2009

On Tue, May 12, 2009 at 10:05 PM, Nikos Mavrogiannopoulos
<nmav at> 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>

More information about the Gnutls-devel mailing list