Paper Info
Title
Tool support for crosscutting concerns of API documentation
Abstract
Writing detailed API (Application Programming Interface) documentation is a significant task for developing a good class library or framework. However, existing documentation tools such as Javadoc provide only limited support and thus the description written by programmers for API documentation often contains scattering text. Occasionally, it also contains tangling text. This paper presents that this problem is due to crosscutting concerns of API documentation. Then it proposes our new tool named Comment-Weaver, which provides several mechanisms for modularly describing API documentation of class libraries or frameworks written in Java or AspectJ. It is an extended Javadoc tool and it provides several new tags for controlling how the text manually written by the programmers is scattering and appended to other entries or how it is moved from the original entry to another entry to be tangling. Finally this paper evaluates CommentWeaver by using three class libraries and frameworks: Javassist, the Java standard library, and Eclipse. It showed that CommentWeaver resolves the problems of scattering or tangling text and it adequately reduces the amount of description written by programmers for API documentation.
Year
DOI
Venue
2010
10.1145/1739230.1739242
AOSD
Keywords
Field
DocType
class library,new tool,extended javadoc tool,crosscutting concern,new tag,good class library,tool support,detailed api,api documentation,existing documentation tool,java standard library,tangling text,application program interface,domain specific language,aspect oriented programming
Domain-specific language,Programming language,Software engineering,Aspect-oriented programming,Computer science,Javadoc,Internal documentation,Application programming interface,AspectJ,Documentation,Java
Conference
Citations 
PageRank 
References 
8
0.49
12
Authors
2
Name
Order
Citations
PageRank
Michihiro Horie1204.18
Shigeru Chiba21281140.78