| 1. | a remark, observation, or criticism: a comment about the weather. |
| 2. | gossip; talk: His frequent absences gave rise to comment. |
| 3. | a criticism or interpretation, often by implication or suggestion: The play is a comment on modern society. |
| 4. | a note in explanation, expansion, or criticism of a passage in a book, article, or the like; annotation. |
| 5. | explanatory or critical matter added to a text. |
| 6. | Also called rheme. Linguistics. the part of a sentence that communicates new information about the topic. Compare topic (def. 4). |
| 7. | to make remarks, observations, or criticisms: He refused to comment on the decision of the court. |
| 8. | to write explanatory or critical notes upon a text. |
| 9. | to make comments or remarks on; furnish with comments; annotate. |
comment programming
(Or "remark") Explanatory text embedded in program source (or less often data) intended to help human readers understand it.
Code completely without comments is often hard to read, but code with too many comments is also bad, especially if the comments are not kept up-to-date with changes to the code. Too much commenting may mean that the code is over-complicated. A good rule is to comment everything that needs it but write code that doesn't need much of it. Comments that explain __why__ something is done and how the code relates to its environment are useful.
A particularly irksome form of over-commenting explains exactly what each statement does, even when it is obvious to any reasonably competant programmer, e.g.
/* Open the input file */ infd = open(input_file, O_RDONLY);
(2007-02-19)