weave - Man Page

translate WEB to TeX

Synopsis

weave [-x] webfile[.web] [{changefile[.ch]|-} [outfile[.tex]]]

Description

This manual page is not meant to be exhaustive.  The complete documentation for this version of T E X can be found in the info file or manual Web2C: A TeX implementation.

The weave program is used to create a T E X file for viewing a WEB program. It takes appropriate care of typographic details like page layout and the use of indentation, italics, boldface, etc., and it supplies extensive cross-index information that it gathers automatically. The command line arguments are the same as for tangle except for the option: -x says to omit the index, module name list, and table of contents pages. (A CONTENTS.tex file will still be written when the T E X file is processed, however, unless some macros in webmac.tex are redefined.)

The output T E X file name is formed by adding .tex to the root of the WEB file name or from the third argument. In this case you can specify '-' as an empty change file.

There are several macros that probably should be redefined by the programmer at the beginning of the WEB file. It is a good idea to set \title to the name of the program. And, to cause output of only changed modules, one can say \let\maybe=\iffalse (usually as the first change in the change file).

Environment

The environment variable WEBINPUTS is used to search for the input files, or the system default if WEBINPUTS is not set.  See tex(1) for the details of the searching.

Files

$TEXMFMAIN/tex/plain/knuth-lib/webmac.tex

T E X macros used by weave output.

See Also

tangle(1) for references, authors, and other information.

Referenced By

mft(1).

02 March 2022 Web2C 2023