Web is a computer programming system created by Donald E. Knuth as the first implementation of what he called "literate programming": the idea that one could create software as works of literature, by embedding source code inside descriptive text, rather than the reverse (as is common practice in most programming languages), in an order that is convenient for exposition to human readers, rather than in the order demanded by the compiler.
Unlike most other documentation generators, which relegate documentation to comments, the WEB approach is to write an article to document the making of the source code. Much like TeX articles, the source is divided into sections according to documentation flow. For example, in CWEB, code sections are seamlessly intermixed in the line of argumentation.
|Paradigm||Literate, imperative (procedural), structured|
|Designed by||Donald Knuth|
|Developer||Donald Knuth & Silvio Levy|
3.67 / October 24, 2006
|Typing discipline||Static, weak, manifest, nominal|
|License||custom free-software license|
CWEB is a computer programming system created by Donald Knuth and Silvio Levy as a follow-up to Knuth's WEB literate programming system, using the C programming language (and to a lesser extent the C++ and Java programming languages) instead of Pascal.
Like WEB, it consists of two primary programs:
- CTANGLE, which produces compilable C code from the source texts, and
- CWEAVE, which produces nicely-formatted printable documentation using TeX.
- Can enter manual TeX code as well as automatic.
- Make formatting of C code for pretty printing.
- Can define sections, and can contain documentation and codes, which can then be included into other sections.
- Write the header code and main C code in one file, and can reuse the same sections, and then it can be tangled into multiple files for compiling.
#linepragmas so that any warnings or errors refer to the .w source.
- Include files.
- Change files, which can be automatically merged into the code when compiling/printing.
- Produces index of identifiers and section names in the printout.
- The TeX Catalogue entry for Web
- CWEB homepage
- Examples of programs written in Web, By Donald Knuth (1981 and onward)