Horde3D

I am currently trying to write a horde3d extension and really miss documentation for all the internal classes, I think it would be better if they were documented in the .h, maybe with doxygen documentation so that one can make a HTML document out of it.
I'd be able to write at least a part of these, the question is, would it be possible for them to get integrated into SVN, and what style should one use? My suggestion:

That isn't actually a working Doxygen style - the brief description has to be on the first line (the line with the double *).

_________________
Tristam MacDonald - [swiftcoding]

hm, ok, I thought that would work with QT_AUTOBRIEF. I usually use a slightly different format for my own docs, but thought this would be better.

Edit: As in the manual, this definately works with JAVADOC_AUTOBRIEF.

I use VA AssistX to generate method documentation, since it is fully configurable, i have no preference regarding documentation style as long as it is consistent and easy to extract.

I'm not a fan of internal class documentation since it clutters up the code so much (especially Doxygen). Personally I prefer having well chosen expressive function and member names and many comments in the code to quickly help understanding what is going on.

It is possible to write doxygen docs in a separate file, and tell it which file that documentation belongs to. This would still enable generating docs, and separate them from the code.

Yes I think you can do this using the @class and @fn commands, I haven't tried it though.