TWILL(1)

💖 TWILL 💖

ok bestie so twill and twill-refsort are literally the duo that translates Web into TeX, mini-indexes included, and yes it's giving main character energy 🎀✨

---

✨ SYNOPSIS ✨

twill [-x] webfile[.web] [{changefile[.ch]|-} [outfile[.tex]]]
twill-refsort < reffile.ref > sreffile.sref

---

🌸 DESCRIPTION 🌸

so twill makes a TeX file for viewing a Web program. it handles all the typographic bestie duties — page layout, indentation, italics, boldface, the whole glow-up — and it also serves up extensive cross-index info in the form of 'mini-indexes' for every spread of pages, plus a 'master index' at the end that it gathers automatically. obsessed. 💅

The command line arguments are the same as for weave, option included: -x says to omit the indexes, module name list, and table of contents pages. (no cap tho — a CONTENTS.tex file will still be written when the TeX file is processed, unless some macros in twimac-web.tex get redefined. 🙈)

The output TeX file name is formed by adding .tex to the root of the Web file name. simple as that, slay.

There are several macros that probably should be redefined by the programmer at the beginning of the Web file. genuinely a good idea to set \title to the name of the program. ⭐

twill is exactly like weave except that it produces better documentation, for which you must work harder. 😭 so real. You should run twill twice — once to prime the pump and once to get decent answers. And lowkey you must run the output twice through TeX too. no shortcuts bestie.

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. periodt. 👑

---

🦋 ENVIRONMENT 🦋

• WEBINPUTS — 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. iykyk 💜

---

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

---

ok that's the whole thing bestie, go forth and document 💖✨

this was the Web2C 2025 era, dated 20 March 2024 — mwah, xoxo 🫶🌸