diff options
author | Norbert Preining <norbert@preining.info> | 2023-12-04 03:01:04 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2023-12-04 03:01:04 +0000 |
commit | db0fe20663f1bcb3fcf87c3fb05a727420edd203 (patch) | |
tree | e5abdee7535ece54123168f0fa9a21fa0a627464 /web/pwebmac/README.md | |
parent | de2c50ca7889fda13da11c1ccf6bdbd199ba8c2b (diff) |
CTAN sync 202312040301
Diffstat (limited to 'web/pwebmac/README.md')
-rw-r--r-- | web/pwebmac/README.md | 18 |
1 files changed, 10 insertions, 8 deletions
diff --git a/web/pwebmac/README.md b/web/pwebmac/README.md index cfd364de09..e85b89cbc4 100644 --- a/web/pwebmac/README.md +++ b/web/pwebmac/README.md @@ -1,7 +1,7 @@ # pwebmac – Consolidated WEB macros for DVI, PDF, and HINT output The original [WEB](https://ctan.org/pkg/web) system by Donald Knuth has the -macros `webmac.tex` that produce DVI output only; for historic reasons, it +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 [pdfTeX](https://ctan.org/pkg/pdftex). @@ -19,7 +19,7 @@ for Martin Ruckert's “[HiTeX](https://ctan.org/pkg/hitex)” engine and its 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](https://www.tug.org/texlive). For this purpose, the shell script -`makeall` was whipped together; it provides various commandline options and +`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`](https://ctan.org/pkg/knuth-pdf) and @@ -27,13 +27,15 @@ of PDF and HINT documents can be browsed in the 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`, `luatex`, 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 +created by `WEAVE` (try `weave -p`). 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…"`, 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`](https://hint.userweb.mwn.de/hint/hintview.html) program. The `pwebmac` package is free software and may be used without constraints. -This is version **4.10** of the `pwebmac` package — 2023-10-07, Andreas Scherer. +This is version **4.11** of the `pwebmac` package — 2023-12-02, Andreas Scherer. |