On 22/08/2011 10:12, Thilo Schulz wrote:
On Monday, 22. August 2011 02:02:24 un dead wrote:
If I made a patch that used doxygen style comments plus a Doxyfile,
would it have a chance of getting accepted? The current comments
aren't useful if you want to generate documentation.
Additionally, the way the functions are laid out, it's harder to grep
for functions. You have to use ctags or something like that because
not every function has a header.
Personally I'm no big fan of automatically generated documentation. And it
only makes sense if you start off your project using these doxygen guidelines
to begin with.
A patch would leave no piece of code untouched, this is a nightmare from the
point of view of someone who regularly merges ioquake3 changes to his project.
I say don't bother.
+1
_______________________________________________
ioquake3 mailing list
ioquake3@lists.ioquake.org
http://lists.ioquake.org/listinfo.cgi/ioquake3-ioquake.org
By sending this message I agree to love ioquake3 and libsdl.
