22 Mar
2011
22 Mar
'11
9:04 p.m.
-----Original Message----- From: Jon Cruz [mailto:jon@...18...] Sent: maandag 21 maart 2011 4:56
First of all, is anyone using our doxygen docs, or does anyone care about the format?
Yes, I care about doxygen, and a little bit about the format. In any case, I think the 'standard' of how to write documentation should be clear to someone who starts writing documentation. For me, it is always a struggle to find a good example in Inkscape's code of how it should be done. For example, how to document a function, specifying what the arguments mean, and what is returned.
I do not care in particular what format is settled on. Although I think the '@brief' does no harm, and don't see the benefit of going to the trouble of deleting it.
Ciao, Johan