CTAN Comprehensive TeX Archive Network

Directory web/pwebmac

README.md

pwebmac – Consolidated WEB macros for DVI, PDF, and HINT output

The original WEB system by Donald Knuth has the macros webmac.tex that produce DVI output only; for historic reasons, they 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 pdf. Jonathan Kew's 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 “ 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 ,” “pdf,” “Lua,” and “” alike. And it adds full support for Martin Ruckert's “Hi” engine and its HINT output format.

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

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 file created by WEAVE (try weave -p). From there, all depends on the “ engine” you use: “plain ” by default creates DVI output, “plain ” with the invocation tex "\let\pdf+\input…", as well as pdftex, luatex, and xetex create PDF output with clickable links and bookmarks (with pdftex and luatex you are advised to apply the “--shell-escape” command-line option in order to avoid an internal miscalculation in the resulting PDF file), 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 5.0 of the pwebmac package — 2024-08-12, Andreas Scherer.

Download the contents of this package in one zip archive (27.6k).

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 modified these macros in his pdfwebmac.tex for PDF output (only) with pdf. Jonathan Kew’s has similar macros xewebmac.tex by Khaled Hosny that modify webmac.tex for PDF output; these macros can only be used with a specific “ 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 ”, pdf, and alike.

Its initial application is the production of PDF files for all major WEB programs for “ and friends” as distributed in 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.

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 file created by weave. From there, all depends on the “ engine” you use.

Packagepwebmac
Supporthttps://lists.tug.org/tex-k
Repositoryhttps://github.com/ascherer/web
Version5.0 2024-08-12
LicensesPublic Domain Software
MaintainerAndreas Scherer
Contained inTeX Live as pwebmac
TopicsLitprog
...
Guest Book Sitemap Contact Contact Author