Using dependence graphs as a support to document programs

被引:9
作者
Balmas, F [1 ]
机构
[1] Univ Paris 08, Dept Informat, Paris, France
来源
SCAM 2002: SECOND IEEE INTERNATIONAL WORKSHOP ON SOURCE CODE ANALYSIS MANIPULATION, PROCEEDINGS | 2002年
关键词
D O I
10.1109/SCAM.2002.1134114
中图分类号
TP [自动化技术、计算机技术];
学科分类号
0812 ;
摘要
lit this paper we argue that source code is not the best support for commenting programs and we introduce dependence graphs as a better support since they offer different levels of abstraction and make visible objects that are not directly represented in the source code. We first introduce our tool to display dependence graphs, focusing on how different views of the same program can be built and tuned by grouping together nodes that are syntactically or conceptually related. We also show how these views make visible objects of the program that aren't accessible for comment in the source code while they can be, in our tool, richly documented through typed annotations. Then we review which kinds of units can be commented this way and discuss a typical way to apply our tool to document programs. Finally, we give strategies towards the automation of program documentation.
引用
收藏
页码:145 / 154
页数:10
相关论文
共 18 条
[1]  
ANTONIOL G, 1997, P INT C SOFTW MAINT
[2]  
BALMAS F, 2001, P WORKSH AN SLIC TRA
[3]  
BALMAS F, 2002, TR20023 U PAR 8
[4]  
BURD E, 2002, P 10 INT WORKSH PROG
[5]  
CHIKOFSKY EJ, 1990, IEEE SOFTWARE, V7
[6]  
CYTRON R, 1989, P 16 ANN ACM S PRINC
[7]  
ERDEM A, 1999, P 6 WORK C REV ENG A
[8]  
HORWITZ S, 1990, ACM TOPLAS JAN
[9]  
KOUTSOFIOS E, 1999, DRAWING GRAPHS DOT
[10]  
OTTENSTEIN K, 1984, P ACM SIGSOFTW SIGPL