8.4. noweb (Important and Actively-Supported Tools - Literate Programming)
Description
This article is from the Literate Programming FAQ, by David B. Thompson thompson@shelob.ce.ttu.edu with numerous contributions by others.
8.4. noweb (Important and Actively-Supported Tools - Literate Programming)
Developer:
Norman Ramsey <nr@eecs.harvard.edu>
Version:
2.9a
Hardware:
Unix and DOS platforms (DOS binaries available for v2.7).
Languages: All programming languages, singly or in combination.
Automatic indexing for C, Icon, Pascal, Standard ML, TeX, Yacc
Formatter:
Plain TeX, LaTeX, and HTML formatters. Will convert LaTeX to
HTML automatically.
Availability:
Anonymous ftp from:
o CTAN:/web/noweb
o LPA:/independent
o Last recourse, use ftp.cs.virginia.edu:pub/nr
Readme:
With bundle above, or see the noweb home page:
www.eecs.harvard.edu/~nr/noweb Those without http access can
consult ``Literate Programming Simplified,'' IEEE Software,
September 1994, pp97-105, or ``Literate Programming Using
Noweb,'' Linux Journal, October 1997, pp64-69.
Description: Noweb is designed to meet the needs of literate
programmers while retaining the simplest possible input format.
Its primary advantages are simplicity, extensibility, and language-
independence. Noweb uses 5 control sequences to WEB's 27. The
noweb manual is only 3 pages; an additional page explains how to
customize its LaTeX output. Noweb works ``out of the box'' with
any programming language, and supports TeX, latex, and HTML back
ends. A back end to support full hypertext or indexing takes about
250 lines; a simpler one can be written in 40 lines of awk. Unlike
WEB, Noweb does not have prettyprinting built in, but there are
several third-party extensions that provide prettyprinting,
includeing dpp, pretzel, and nwpp.
Noweb supports indexing and identifier cross-reference,
including hypertext ``hot links.'' noweb includes a simple,
efficient LaTeX-to-HTML converter, so you can use hypertext
browsers on your legacy documents. Noweb can also process nuweb
programs, so you can use noweb to convert a standard nuweb
program to HTML with one command.
Support:
email to the author
Continue to:
My Books
