Elucidative programming in Java

In this paper we describe the ideas of Elucidative Programming. With Elucidative Programming we are primarily concerned with documentation of program understanding, and presentation of such understanding on the World Wide Web. In a broader perspective, we are interested in support of any technical writing which needs to address source program constituents. We claim that Elucidative Programming may be helpful for these purposes, mainly due to a documentation model based on relations between places in the documentation and program constituents. The main section in the paper introduces a concrete Elucidator tool for Java. We use this tool as outset for a discussion of collaboration and teamwork centered in WWW based program presentations.

[1]  Kurt Nørmark,et al.  Rich hypertext: a foundation for improved interaction techniques , 1995, Int. J. Hum. Comput. Stud..

[2]  Kurt Nørmark,et al.  An interaction engine for rich hypertexts , 1994, ECHT '94.

[3]  Kurt Nørmark,et al.  Elucidative Programming , 2000, Nord. J. Comput..

[4]  R. Kent Dybvig,et al.  Revised5 Report on the Algorithmic Language Scheme , 1986, SIGP.

[5]  Jeffrey L. Korn,et al.  Chava: reverse engineering and tracking of Java applets , 1999, Sixth Working Conference on Reverse Engineering (Cat. No.PR00303).

[6]  Glenn S. Fowler,et al.  Ciao: a graphical navigator for software and document repositories , 1995, Proceedings of International Conference on Software Maintenance.

[7]  Jonathan Rees,et al.  Revised3 report on the algorithmic language scheme , 1986, SIGP.

[8]  Andrew Johnson,et al.  Literate Programming Using Noweb , 1997 .

[9]  Lisa Friendly,et al.  The Design of Distributed Hyperlinked Programming Documentation , 1995, IWHD.

[10]  Ross N. Williams,et al.  FunnelWeb User's Manual , 1992 .

[11]  Silvio Levy,et al.  The CWEB system of structured documentation - version 3.0 , 1994 .

[12]  Donald E. Knuth,et al.  Literate Programming , 1984, Comput. J..

[13]  John D. Ramsdell,et al.  Nuweb A Simple Literate Programming Tool , 2000 .

[14]  Kurt Nørmark,et al.  Requirements for an elucidative programming environment , 2000, Proceedings IWPC 2000. 8th International Workshop on Program Comprehension.

[15]  Kurt Nørmark An Elucidative Programming Environment for Scheme , 2000 .