arrow
Return

Classifying code comments in Java software systems

delete2019-04-26
delete34
delete
OA
AI
L
Luca Pascarella *
M
Magiel Bruntink
A
Alberto Bacchelli
DOI:10.1007/s10664-019-09694-wdelete
deleteOriginal
deleteShare
deleteSave
View PDF
Abstract

Abstract

En 中文
Code comments are a key software component containing information about the underlying implementation. Several studies have shown that code comments enhance the readability of the code. Nevertheless, not all the comments have the same goal and target audience. In this paper, we investigate how 14 diverse Java open and closed source software projects use code comments, with the aim of understanding their purpose. Through our analysis, we produce a taxonomy of source code comments; subsequently, we investigate how often each category occur by manually classifying more than 40,000 lines of code comments from the aforementioned projects. In addition, we investigate how to automatically classify code comments at line level into our taxonomy using machine learning; initial results are promising and suggest that an accurate classification is within reach, even when training the machine learner on projects different than the target one. Data and Materials [10.5281/zenodo.2628361].
Keywords:
Code comments usage
Code comment classification
Dataset
AI Summary

AI Summary

Key information extracted from the uploaded paper, including a brief overview, abstract, background, key highlights, visual analysis, and future outlook.

Journal

Empirical Software Engineering cover
Empirical Software Engineering
IF:
3.6
Papers:
2.0K
Citations:
5.3K

Organization

D
Delft University of Technology
Scholars:
2.6W
Papers: 2.5W
Citations: 3.8W
U
university of zurich
Scholars:
5.1W
Papers: 4.0W
Citations: 65
Cited Papers

Cited Papers

Urinary retention following routine neurosurgical spine procedures
err2001-01-01
err0
PREAI
errNicholas M Boulis; Farukh S Mian; David Rodriguez; Edward Cho; Julian T Hoff
errShare
errSave
Free posterior tibial perforator flap: Anatomy and a report of 6 cases
err1996-01-01
err0
PREAI
errLeung-Kim Hung; Jie Lao; Pak-Cheong Ho
errShare
errSave
Code quality analysis in open source software development
err2002-02-08
err171
PREAI
errStamelos, I; Angelis, L; Oikonomou, A; Bleris, GL
errShare
errSave
Adiabatic nanofocusing: spectroscopy, transport and imaging investigation of the nano world
err2014-11-04
err0
PREAI
errA Giugni; M Allione; B Torre; G Das; M Francardi; M Moretti; M Malerba; G Perozziello; P Candeloro; E Di Fabrizio
errShare
errSave
errShare
errSave
Amine− and Phosphine−Borane Adducts: New Interest in Old Molecules
err2010-07-14
err0
PREAI
errAnne Staubitz; Alasdair P. M. Robertson; Matthew E. Sloan; Ian Manners
errShare
errSave
researcher View more