NAME¶

twill, twill-refsort - translate 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 Web program.It takes appropriate care of typographic details like pagelayout and the use of indentation, italics, boldface, etc., and it suppliesextensive cross-index information in the form of 'mini-indexes' for eachspread of pages and a 'master index' at the end that it gathers automatically.

The command line arguments are the same as forweaveincluding the option:-xsays to omit the indexes, module name list, and table of contents pages.(ACONTENTS.texfile will still be written when the TeX file is processed,however, unless some macros intwimac-web.texare redefined.)

The output TeX file name is formed by adding.texto the root of the Web file name.

There are several macros that probably should be redefined bythe programmer at the beginning of the Web file.It is a good idea to set\titleto the name of the program.

twillis exactly likeweaveexcept that it produces better documentation, for which you must work harder.You should runtwilltwice, once to prime the pump and once to get decent answers.Moreover, you must run the output twice through TeX.

Aftertex fooyou will have output that looks like final pagesexcept that the entries of mini-indexes won’t be alphabetized.The first run produces a weird file calledfoo.ref.Saytwill-refsort < foo.ref > foo.srefand then anothertex foowill produce alphabetized output.

ENVIRONMENT¶

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

FILES¶

$TEXMFMAIN/tex/plain/cweb/cwebbin/twimac-web.tex

TeX macros used bytwilloutput.

SEE ALSO¶

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