Hello
I've been programming for a number of years, however my commenting style is
always different.
Sometimes I use something like:
/************************
* method ....
* comments...
*************************/
Sometimes I use:
//
// this function is for this and that...
// ...
etc...then when it comes to write documents about my code, I'ld have to
rewrite lots of explanation about the code in another document.
I don't know what style to adopt and what tools can later parse my code and
generate documentation out of my specially formatted comments. (for example
Javadoc, can parse source-code and generate comments)
What do you use?
What do you suggest?
Regards,
Elias