Documentation comments

Question

For what are documentation comments used and what are the differences between them and multi-line/single line comments?

Answer 1

Multi/single line comments are created by the developer/coder, it is used as self documentation, or a quick reminder of what a piece or block of code is for or what it does.

Documentation comments are generally created by documentation utilities, but developers can also write comments following the documentation tool format to allow the manual comments be recognized by the tool.

Documentation comments use specific formatting used by the utility wizard to build project documentation, usually documentation comments include details of the thing it is documenting, e.g. argument list & type, or return value for documentation of methods, or detailed list of members for classes documentation.

https://www.stack.nl/~dimitri/doxygen/manual/docblocks.html

Hth, cmiiw

Answer 2

All comments are helpful

Answer 3

first of all it's useful for u, ....
with out comments , if u write a code and then come back to it after a year. ..... u probably are gonna say " what the heck I was trying to do here!!!"....
and secondly it's useful if u wanna pass ur code to someone else (like a teammate of ur programming group)

Answer 4

the only difference is the number of lines

Answer 5

and one more thing.... sometimes comments (mostly the ones in a document ) are used as a guide line for writing codes . ( meaning it has been created before getting ur hands on the code)

Answer 6

@Rapha. 👍
long story short. ha?!😂

Answer 7

Which software or tool is used for preparing software documentation?