CloCom: Mining existing source code for automatic comment generation

Citations Over TimeTop 10% of 2015 papers

Abstract

Code comments are an integral part of software development. They improve program comprehension and software maintainability. The lack of code comments is a common problem in the software industry. Therefore, it is beneficial to generate code comments automatically. In this paper, we propose a general approach to generate code comments automatically by analyzing existing software repositories. We apply code clone detection techniques to discover similar code segments and use the comments from some code segments to describe the other similar code segments. We leverage natural language processing techniques to select relevant comment sentences. In our evaluation, we analyze 42 million lines of code from 1,005 open source projects from GitHub, and use them to generate 359 code comments for 21 Java projects. We manually evaluate the generated code comments and find that only 23.7% of the generated code comments are good. We report to the developers the good code comments, whose code segments do not have an existing code comment. Amongst the reported code comments, seven have been confirmed by the developers as good and committable to the software repository while the rest await for developers' confirmation. Although our approach can generate good and committable comments, we still have to improve the yield and accuracy of the proposed approach before it can be used in practice with full automation.

Related Papers

• → Learning to Generate Pseudo-Code from Source Code Using Statistical Machine Translation(2015)260 cited
• → Identifying Auto-Generated Code by Using Machine Learning Techniques(2016)19 cited
• → Pseudogen: A Tool to Automatically Generate Pseudo-Code from Source Code(2015)14 cited
• → Code Coverage and Fuzzing(2007)
• Evaluation of the efficiency and fault density of software generated by code generators