loading...
 This Article 
   
 Share 
   
 Bibliographic References 
   
 Add to: 
 
Digg
Furl
Spurl
Blink
Simpy
Google
Del.icio.us
Y!MyWeb
 
 Search 
   
Second IEEE International Workshop on Source Code Analysis and Manipulation (SCAM'02)
Using Dependence Graphs as a Support to Document Programs
Montreal, Canada
October 01-October 01
ISBN: 0-7695-1793-5
Françoise Balmas, Université Paris 8

In 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.

Citation:
Françoise Balmas, "Using Dependence Graphs as a Support to Document Programs," scam, pp.145, Second IEEE International Workshop on Source Code Analysis and Manipulation (SCAM'02), 2002
Usage of this product signifies your acceptance of the Terms of Use.