CWEB

From Wikipedia, the free encyclopedia
Jump to navigation Jump to search
CWEB
ParadigmLiterate, imperative (procedural), structured
Designed byDonald Knuth
DeveloperDonald Knuth & Silvio Levy
First appeared1987; 34 years ago (1987)
Stable release
3.67 / October 24, 2006; 14 years ago (2006-10-24)
Typing disciplineStatic, weak, manifest, nominal
OSCross-platform (multi-platform)
Licensecustom free-software license
Filename extensions.w
Websitewww-cs-faculty.stanford.edu/~uno/cweb.html
Influenced by
WEB, TeX
Influenced
noweb

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.

Philosophy[edit]

Unlike most other documentation generators which relegate documentation to comments, CWEB 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. C code sections are seamlessly intermixed in the line of argumentation.[1]

Features[edit]

  • 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.
  • Use #line pragmas 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.

See also[edit]

References[edit]

  1. ^ Silvio Levy (12 June 2004). "An example of CWEB" (PDF).

External links[edit]