Doxygen
Stewart Gordon
smjg_1998 at yahoo.com
Sat Feb 4 15:15:44 PST 2012
For my libraries I have been using Doxygen to generate documentation. This is partly a
carry-over from before DDoc was invented, and partly because on the whole it's a powerful
documentation system aside from its limited D support requiring the use of a filter
program to plug in the holes. And that program is still here:
http://www.dsource.org/projects/bindings/browser/trunk/dfilter.d
I've realised that dfilter hasn't been updated since 2007, when Doxygen 1.4.2 was current.
And I haven't really kept up much since work commitments have limited my time to work on
my D projects. It's a shame that nothing's come of the community's attempts to get
Doxygen supporting D properly.
And now that D2 has introduced new stuff to worry about, Doxygen is going to struggle to
catch up. I'm not even sure the best way to filter const/immutable/inout return types so
that Doxygen parses them correctly, short of changing them to C++ notation. It's bad
enough being still stuck with :: in places, thinking all aliases are types and so on,
without having to go back to the C++ way of expressing other things.
Is anyone here still using Doxygen with D? If so, how have you managed with its poor D
support?
Or has DDoc taken over the trade?
Stewart.
More information about the Digitalmars-d
mailing list