digitalmars.D - Doxygen
- Stewart Gordon (18/18) Feb 04 2012 For my libraries I have been using Doxygen to generate documentation. T...
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.
Feb 04 2012