NAME

twill, twill-refsort - translate a literate programming WEB to TeX with mini-indexes

SYNOPSIS

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

twill-refsort < reffile.ref > sreffile.sref

DESCRIPTION

The twill program is used to create a TeX file for viewing a literate program written in WEB. The output TeX file name is formed by adding .tex to the root of the file name.

twill is like weave(1), but also supplies cross-reference information in the form of `mini-indexes' for each spread of pages, for identifiers used on that spread, and a `master index' at the end that it gathers automatically.

You need to run twill twice, once to prime the pump and once to get decent answers. Moreover, you must run the output twice through TeX.

For a program foo.web, after a first tex foo you will have output that looks like final pages except that the entries of mini-indexes will not be alphabetized. The first run produces an auxiliary file named foo.ref.
Run twill-refsort <foo.ref >foo.sref and then another tex foo will produce alphabetized output.

OPTIONS

See tex(1) for details of command-line parsing, and weave(1) for options accepted.

ENVIRONMENT

The environment variable WEBINPUTS is used to search for the input files, If it is not set, it uses the system default. See the Kpathsea manual at https://tug.org/kpathsea for the details of the searching.

BUGS

The table of contents file, CONTENTS.tex, is generated but ignored (unless macros in twimac-web.tex are redefined).

FILES

$TEXMFMAIN/tex/plain/cweb/cwebbin/twimac-web.tex: TeX macros used by twill output.