AOPS: an abstraction-oriented programming system for literate programming

Abstract

The practice of literate programming is not widespread because existing literate programming systems have some undesirable characteristics such as programming language and text processor dependence and lack of flexible tools for viewing and manipulation of the source file. This paper describes the literate programming system AOPS (Abstraction Oriented Programming System) which addresses both of these problems. AOPS is programming language and text processor independent literate programming system. AOPS tools include a hypertext browser, a lister with the ability to select what is presented and what is suppressed, and a filter to extract the program code from the AOPS source file. AOPS introduces the notion of a phantom abstraction that enhances the understandability of the literate program and when used in conjunction with the browser greatly extends the capabilities of AOPS. We also discuss how the design of AOPS supports extension of the concept of literate programming. Finally we report the results of a preliminary experiment that showed that literate programs contain more documentation than traditional programs.

Hidden messages: evaluating the efficiency of code elision in program navigation

“…Thimbleby (1986) reported that student projects written as literate programs had higher quality documentation that was better integrated with the code. Shum & Cook (1994) compared sixteen student programming assignments, half written with and half without support of a literate programming tool called AOPS (Shum & Cook 1993). Results showed that literate programming promoted more and higher quality documentation.…”

Literate Programming to Enhance Agile Methods

“…[6], [16], [18]. LP emphasises these advantages and diminishes likelihood on incurring the disadvantages through better consistency between code and documentation [19]. When using LP, the XP team no longer has to minimize documentation to avoid its disadvantages.…”