pwebmac – Consolidated WEB macros for DVI and PDF output

The original WEB system by Donald Knuth has the macros webmac.tex that produce DVI output only; for historic reasons, it will never be modified (apart from catastrophic errors). Hàn Thế Thành has extended these macros in his (outdated?) pdfwebmac.tex for PDF output (only) with pdfTeX. Jonathan Kew's XeTeX has similar macros xewebmac.tex by Khaled Hosny that include and modify webmac.tex for PDF output; all these macros can only be used with a specific “TeX engine” each.

The present pwebmac package integrates these three WEB macro files similar to cwebmac.tex in Silvio Levy's and Don Knuth's CWEB system, so pwebmac.tex can be used with “plain TeX,” “pdfTeX,” and “XeTeX” alike. And it adds full support for Martin Ruckert's “HiTeX” engine and its HINT output format.

Its initial application is the production of PDF and HINT files for all major WEB programs for “TeX and friends” as distributed in TeX Live. For this purpose, the shell script makeall was whipped together; it provides various commandline options and works around several “quirks” in the WEB sources. The resulting collection of PDF documents can be browsed in the knuth-pdf package and the collection of HINT documents are available in the knuth-hint package.

WEB programmers who want to use pwebmac.tex instead of the default webmac.tex in their programs have to change the first line in the TeX file created by weave. From there, all depends on the “TeX engine” you use: “plain TeX” by default creates DVI output, “plain TeX” with the invocation tex "\let\pdf+\input…", pdftex, and xetex create PDF output with clickable links and bookmarks (depending on your PDF viewer), and hitex creates HINT output that can be viewed with the hintview program.

The pwebmac package is free software and may be used without constraints.

This is version “4.8.1” of the pwebmac package — 2022-06-25, Andreas Scherer.