On Fri, Jun 22, 2001 at 03:00:41AM -0700, David Freeman wrote:
All,
Documentation: Does any one know of a javadoc equivilent for C?
[trj@twoey ~]$ apt-cache show cweb Package: cweb Priority: optional Section: devel Installed-Size: 288 Maintainer: Julian Gilbey jdg@debian.org Architecture: i386 Version: 3.63-4 Depends: libc6 (>= 2.2.3-1) Recommends: c-compiler | g++ | c++-compiler, tetex-base, tetex-bin (>>1.0) Suggests: cwebx Filename: pool/main/c/cweb/cweb_3.63-4_i386.deb Size: 189164 MD5sum: f079cf9fb6303648d244b8dcb02003b3 Description: Knuth's & Levy's C/C++ programming system. CWEB allows you to write documents which can be used simultaneously as C/C++ programs and as TeX documentation for them. .
The philosophy behind CWEB is that programmers who want to provide the best possible documentation for their programs need two things simultaneously: a language like TeX for formatting, and a language like C for programming. Neither type of language can provide the best documentation by itself. But when both are appropriately combined, we obtain a system that is much more useful than either language separately.