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¶

Thetwillprogram is used to create a TeX file for viewing a literate programwritten in WEB. The output TeX file name is formed by adding.texto the root of the WEB 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 thatspread, and a `master index' at the end that it gathers automatically.

You need to runtwilltwice, 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 fooyou will have output that looks like final pagesexcept that the entries of mini-indexes will not be alphabetized.The first run produces an auxiliary file namedfoo.ref.
Runtwill-refsort <foo.ref >foo.srefand then anothertex foowill produce alphabetized output.

OPTIONS¶

Seetex(1)for details of command-line parsing, andweave(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 theKpathsea manual at https://tug.org/kpathsea for the details of thesearching.

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 bytwilloutput.

SEE ALSO¶

tangle(1)for references, authors, and other information about WEB in general.

Donald E. Knuth, Mini-indexes for literate programs,Software-Concepts and Tools, 15(1):2-11, 1994.
https://arxiv.org/abs/cs/9401102

CTWILL program source, section 287:
https://mirror.ctan.org/info/knuth-pdf/cweb/ctwill.pdf
(Not all features described there are available in the oldertwill system, but you will get the gist.)

Public discussion list and bug reports: https://lists.tug.org/tex-k