# weave - translate WEB to TeX - man(1) - [phpMan]

[_WEAVE_(1)](https://www.chedong.com/phpMan.php/man/WEAVE/1/markdown)                               General Commands Manual                              [_WEAVE_(1)](https://www.chedong.com/phpMan.php/man/WEAVE/1/markdown)

## NAME
       weave - 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 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 program.  It takes appropri‐
       ate care of typographic details like page layout and the use of indentation,  italics,  bold‐
       face,  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 TeX file is processed, however, unless some macros in _webmac.tex_ are rede‐
       fined.)

       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 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 de‐
       fault if WEBINPUTS is not set.  See [**tex**(1)](https://www.chedong.com/phpMan.php/man/tex/1/markdown) for the details of the searching.

## FILES
       _$TEXMFMAIN/tex/plain/knuth-lib/webmac.tex_
           TeX macros used by **weave **output.

## SEE ALSO
       [**tangle**(1)](https://www.chedong.com/phpMan.php/man/tangle/1/markdown) for references, authors, and other information.

Web2C 2023                                  02 March 2022                                   [_WEAVE_(1)](https://www.chedong.com/phpMan.php/man/WEAVE/1/markdown)