WEAVE(1) General Commands Manual WEAVE(1)
NAME
weave - translate WEB to TeX
SYNOPSIS
weave [-p] [-x] webfile[.web] [{changefile[.ch]|-} [outfile[.tex]]]
DESCRIPTION
This manual page is not meant to be exhaustive. The complete documenta-
tion for this version of TeX can be found in the info file or manual
Web2C: A TeX implementation.
The weave program is used to create a TeX file for viewing a Web pro-
gram. It takes appropriate care of typographic details like page layout
and the use of indentation, italics, boldface, etc., and it supplies ex-
tensive cross-index information that it gathers automatically. The com-
mand line arguments are the same as for tangle except for the options:
-p says to use alternative macros more suited for PDF output. -x says
to omit the index, module name list, and table of contents pages. (A
CONTENTS.tex file will still be written when the TeX file is processed,
however, unless some macros in webmac.tex are redefined.)
The output TeX 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 pro-
grammer at the beginning of the Web file. It is a good idea to set \ti-
tle 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
TeX macros used by weave output.
$TEXMFMAIN/tex/plain/pwebmac/pwebmac.tex
alternative TeX macros used for PDF output.
SEE ALSO
tangle(1) for references, authors, and other information.
Web2C 2025/dev 13 October 2023 WEAVE(1)
Generated by dwww version 1.16 on Tue Dec 16 04:43:47 CET 2025.