Abstract:Code comment generation is the task of generating a high-level natural language description for a given code method or function. Although researchers have been studying multiple ways to generate code comments automatically, previous work mainly considers representing a code token in its entirety semantics form only (e.g., a language model is used to learn the semantics of a code token), and additional code properties such as the tree structure of a code are included as an auxiliary input to the model. There are two limitations: 1) Learning the code token in its entirety form may not be able to capture information succinctly in source code, and 2) The code token does not contain additional syntactic information, inherently important in programming languages. In this paper, we present LAnguage Model and Named Entity Recognition (LAMNER), a code comment generator capable of encoding code constructs effectively and capturing the structural property of a code token. A character-level language model is used to learn the semantic representation to encode a code token. For the structural property of a token, a Named Entity Recognition model is trained to learn the different types of code tokens. These representations are then fed into an encoder-decoder architecture to generate code comments. We evaluate the generated comments from LAMNER and other baselines on a popular Java dataset with four commonly used metrics. Our results show that LAMNER is effective and improves over the best baseline model in BLEU-1, BLEU-2, BLEU-3, BLEU-4, ROUGE-L, METEOR, and CIDEr by 14.34%, 18.98%, 21.55%, 23.00%, 10.52%, 1.44%, and 25.86%, respectively. Additionally, we fused LAMNER's code representation with the baseline models, and the fused models consistently showed improvement over the non-fused models. The human evaluation further shows that LAMNER produces high-quality code comments.

Learning to Generate Comments for API-Based Code Snippets

Software Engineering and Methodology for Emerging Domains: 16th National Conference, NASAC 2017, Harbin, China, November 4–5, 2017, and 17th National Conference, NASAC 2018, Shenzhen, China, November 23–25, 2018, Revised Selected Papers

Automating Just-In-Time Comment Updating

APIContext2Com: Code Comment Generation by Incorporating Pre-Defined API Documentation

Why My Code Summarization Model Does Not Work: Code Comment Improvement with Category Prediction

Retrieve and Refine: Exemplar-based Neural Comment Generation

Why My Code Summarization Model Does Not Work

Neural Comment Generation for Source Code with Auxiliary Code Classification Task

From Code to Natural Language: Type-Aware Sketch-Based Seq2Seq Learning

DeepCommenter: a Deep Code Comment Generation Tool with Hybrid Lexical and Syntactical Information

API2Com: On the Improvement of Automatically Generated Code Comments Using API Documentations

Integrating Extractive and Abstractive Models for Code Comment Generation

Deep Code Comment Generation with Hybrid Lexical and Syntactical Information

A Simple Retrieval-based Method for Code Comment Generation

CloCom: Mining existing source code for automatic comment generation

LAMNER: Code Comment Generation Using Character Language Model and Named Entity Recognition

AUGER: Automatically Generating Review Comments with Pre-training Models

Code to Comment "Translation": Data, Metrics, Baselining & Evaluation

MESIA: Understanding and Leveraging Supplementary Nature of Method-level Comments for Automatic Comment Generation

A Survey of Automatic Generation of Source Code Comments: Algorithms and Techniques

SeCNN: A semantic CNN parser for code comment generation