ACM SIGPLAN Notices
Comments, assertions and pragmas
ACM SIGPLAN Notices
Language Design for Program Manipulation
IEEE Transactions on Software Engineering
Enhancing program comprehension: formatting and documenting
ACM SIGPLAN Notices
Proceedings of the 30th international conference on Software engineering
Analyzing the co-evolution of comments and source code
Software Quality Control
R-technology: A soviet visual programming environment
Journal of Visual Languages and Computing
| Hi-index | 0.00 |
The purpose of this paper is to open discussion on the adequacy and design of commenting techniques in programming (and, indeed, all computer processing) languages. The argument is made that the common notion of comment statements is too simplistics, and that a powerful alternative exists. A distinction is made between simple comment statements and scoped comments. Two types of scoped comments are mentioned, and their weaknesses are considered. The paper ends with a call for language designers to address this issue.