FreeBSD Manual Pages
TWILL(1) General Commands Manual TWILL(1) 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 The twill program is used to create a TeX file for viewing a Web pro- gram. It takes appropriate care of typographic details like page lay- out and the use of indentation, italics, boldface, etc., and it sup- plies extensive cross-index information in the form of 'mini-indexes' for each spread of pages and a 'master index' at the end that it gath- ers automatically. The command line arguments are the same as for weave including the op- tion: -x says to omit the indexes, module name list, and table of con- tents pages. (A CONTENTS.tex file will still be written when the TeX file is processed, however, unless some macros in twimac-web.tex are redefined.) The output TeX file name is formed by adding .tex to the root of the Web file name. 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 \title to the name of the program. twill is exactly like weave except that it produces better documenta- tion, for which you must work harder. You should run twill twice, once to prime the pump and once to get decent answers. Moreover, you must run the output twice through TeX. After tex foo you will have output that looks like final pages except that the entries of mini-indexes won't be alphabetized. The first run produces a weird file called foo.ref. Say twill-refsort < foo.ref > foo.sref and then another tex foo will 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. See tex(1) for the details of the searching. FILES $TEXMFMAIN/tex/plain/cweb/cwebbin/twimac-web.tex TeX macros used by twill output. SEE ALSO tangle(1) for references, authors, and other information. Web2C 2025 20 March 2024 TWILL(1)
NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | FILES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=twill-refsort&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>