Abstract:The ellipsis of the syntactic structure is a common phenomenon in ordinary textual documents. Existing studies have found that despite syntactic ellipsis could help avoid repetition of normative documents, it could also, for example, lead to ambiguity and hamper the understandability of document contents. As a fundamental component of software, code comments are generally written by developers in a non-structured way just like normative documents. This naturally inspires us to explore whether syntactic ellipsis is also a common phenomenon in code comments and what potential negative effects would such ellipsis have on software tasks such as code/comments comprehension activities. Such explorations, in our opinion, are expected to facilitate the research on code comments and comments-related software tasks. To this end, we conduct the first large-scale study to explore the syntactic structure ellipsis problem of code comments, with a focus on Java inline comments. Specifically, we construct a data set of 1,000 Java projects with 1,307,457 inline comments and associated codes. Based on this data set, we first study the prevalence of syntactic structure ellipsis in inline comments. We find that syntactic structure ellipsis is quite common in inline comments where 83.6% comments have structure ellipsis (such as subject/predicate omissions). Then, we investigate the effects of syntactic structure ellipsis on code/comment understanding activities. As a result, we find that there indeed exists a negative relationship between them, with a medium effect size. Based on these findings, we further propose neural network based approaches to complete the ellipsis parts for the inline comments. With our approach, we could achieve: 1) a medium improvement in assisting code/comment understanding activities, and 2) a substantial improvement of 11.3% in comment-assisted code abbreviation extension task.

Analyzing program readability based on WordNet

Why My Code Summarization Model Does Not Work

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

Code Comments: A Way of Identifying Similarities in the Source Code

Analyzing Code Comments to Boost Program Comprehension

Investigating the Impact of Vocabulary Difficulty and Code Naturalness on Program Comprehension

Deep Code Comment Generation with Hybrid Lexical and Syntactical Information

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

Application-Oriented Comparison and Evaluation of Six Semantic Similarity Measures Based on Wordnet

Automatic Code Summarization: A Systematic Literature Review

A Graph-based Readability Assessment Method Using Word Coupling.

Query expansion via WordNet for effective code search

Transferring Java Comments Based on Program Static Analysis.

Towards the Analysis and Completion of Syntactic Structure Ellipsis for Inline Comments

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

On the Lexical Distinguishability of Source Code

Demystifying and Assessing Code Understandability in Java Decompilation

CodeAttention: Translating Source Code to Comments by Exploiting the Code Constructs

Automating Comment Generation for Smart Contract from Bytecode

GRAW+: A Two‐view Graph Propagation Method with Word Coupling for Readability Assessment

CPC: Automatically Classifying and Propagating Natural Language Comments via Program Analysis