Affiliation:
1. 1386 Friar Lane, Columbus OH,
Abstract
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.
Publisher
Association for Computing Machinery (ACM)
Subject
Computer Graphics and Computer-Aided Design,Software
Reference2 articles.
1. Problems With Automatic Restructurers;Calliss P.W.;SIGPLAN Notices,1988
Cited by
13 articles.
订阅此论文施引文献
订阅此论文施引文献，注册后可以免费订阅5篇论文的施引文献，订阅后可以查看论文全部施引文献
1. Generating Variable Explanations via Zero-shot Prompt Learning;2023 38th IEEE/ACM International Conference on Automated Software Engineering (ASE);2023-09-11
2. Automatically detecting the scopes of source code comments;Journal of Systems and Software;2019-07
3. A Large-Scale Empirical Study on Code-Comment Inconsistencies;2019 IEEE/ACM 27th International Conference on Program Comprehension (ICPC);2019-05
4. Automatically Detecting the Scopes of Source Code Comments;2018 IEEE 42nd Annual Computer Software and Applications Conference (COMPSAC);2018-07
5. Analyzing the co-evolution of comments and source code;Software Quality Journal;2009-03-26