A source code documentation system for Ada
暂无分享,去创建一个
The chief virtues of the Web system are that it encourages consistency between code and documentatio n and it supports the production of high-quality typeset documentation in a uniform style . With Web th e source code and documentation of a program are combined in a single file . There are two programs, Weav e and Tangle, which produce Tl typesetting commands and compilable source code, respectively, from the Web file . Since Tangle automatically organizes the code fragments into a compilable order as it extract s them from the Web file, the author is freed of syntactic constraints imposed by the programming language , and can structure the Web file in a way that makes the final typeset documentation most readable . Anyon e who has attempted to typeset computer program code manually and maintain consistency between sourc e code and typeset documentation for succesive versions of a program will readily appreciate these virtues .
[1] Jon Bentley,et al. Programming pearls: literate programming , 1986, CACM.
[2] Jon L. Bentley,et al. Programming pearls: the envelope is back , 1986, CACM.
[3] Donald E. Knuth,et al. The CWEB system of structured documentation - version 3.0 , 1994 .
[4] Jon Louis Bentley,et al. Programming pearls: a literate program , 1986, CACM.