WEAVE(1)

✨ WEAVE(1) ✨

okay bestie, so like — weave is the glow-up queen that takes your WEB source and turns it into a TeX file. translating WEB to TeX, that's the whole job. 💅

---

NAME

weave — translate WEB to TeX 🦋

---

SYNOPSIS

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

---

DESCRIPTION

ngl, this manual page is not meant to be exhaustive. the full complete documentation for this version of TeX lives in the info file or in the manual Web2C: A TeX implementation. so like, go read those if you want the whole lore 📚

The weave program is used to create a TeX file for viewing a Web program. It takes appropriate care of typographic details like page layout and the use of indentation, italics, boldface, etc., and it supplies extensive cross-index information that it gathers automatically — it's giving main character energy, honestly, it does all that by itself. 🤖✨

The command line arguments are the same as for tangle, except for the options:

• -p — says to use alternative macros more suited for PDF output. 🎀
• -x — says to omit the index, module name list, and table of contents pages. (A CONTENTS.tex file will still be written when the TeX file is processed, however, unless some macros in webmac.tex are redefined.) 🫶

The output TeX file name is formed by adding .tex to the root of the Web file name, or it comes from the third argument. In this case you can specify - as an empty change file. 💀 (yes, a literal dash, as the empty change file — iconic)

---

macros you probs wanna redefine bestie

There are several macros that probably should be redefined by the programmer at the beginning of the Web file. It is a good idea to set \title to the name of the program. And, to cause output of only changed modules, one can say \let\maybe=\iffalse (usually as the first change in the change file). 🌸

---

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/knuth-lib/webmac.tex — TeX macros used by weave output. ✨
• $TEXMFMAIN/tex/plain/pwebmac/pwebmac.tex — alternative TeX macros used for PDF output. 🎀

---

SEE ALSO

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

---

fr fr, that's the whole page — no cap. go weave something beautiful. 🌈

and that's the vibe check, bestie — this page came from Web2C, dated 20 March 2024. periodt. 👑💖