diff options
author | Norbert Preining <norbert@preining.info> | 2024-07-11 03:01:39 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2024-07-11 03:01:39 +0000 |
commit | 2060043b2a5921ac96e4c0c84215e5bfb5d6388b (patch) | |
tree | 5dec1755e30762cd08064ad6ef5308d4690bdd09 /info | |
parent | 835d1c8d3de2b2316395e9613def9ca693c485c1 (diff) |
CTAN sync 202407110301
Diffstat (limited to 'info')
-rw-r--r-- | info/knuth-hint/README.md | 2 | ||||
-rw-r--r-- | info/knuth-pdf/README.md | 55 |
2 files changed, 21 insertions, 36 deletions
diff --git a/info/knuth-hint/README.md b/info/knuth-hint/README.md index 1e8091d597..2871f31177 100644 --- a/info/knuth-hint/README.md +++ b/info/knuth-hint/README.md @@ -21,4 +21,4 @@ The “License” of the `knuth-hint` package is “Public Domain” and it cove the contents of this package, _not_ the various (and varying) “free software” licenses of the presented software codes. -This is version “2.3” of the `knuth-hint` package — 2024-05-20, Andreas Scherer. +This is version “2.4” of the `knuth-hint` package — 2024-07-10, Andreas Scherer. diff --git a/info/knuth-pdf/README.md b/info/knuth-pdf/README.md index f2554f6fb9..0ae94e0eb0 100644 --- a/info/knuth-pdf/README.md +++ b/info/knuth-pdf/README.md @@ -1,41 +1,26 @@ -# pwebmac – Consolidated WEB macros for DVI, PDF, and HINT output +# knuth-pdf – PDF collection of typeset C/WEB sources in TeX Live -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, 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). -Jonathan Kew's [XeTeX](https://ctan.org/pkg/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. +Here you find a large collection of PDF documents for many C/WEB programs in +TeX\ Live, both in their original form as written by their respective authors, +and in the changed form as they are actually used in the TeX Live system. Care +has been taken to keep the section numbering intact, so that you can study the +sources and their changes in parallel. Also included is the collection of +‘errata’ for Donald Knuth's “Computers & Typesetting” series. -The present `pwebmac` package integrates these three WEB macro files similar -to `cwebmac.tex` in Silvio Levy's and Don Knuth's -[CWEB](https://ctan.org/pkg/cweb) system, so `pwebmac.tex` can be used with -“plain TeX,” “pdfTeX,” “LuaTeX,” and “XeTeX” alike. And it adds full support -for Martin Ruckert's “[HiTeX](https://ctan.org/pkg/hitex)” engine and its -[`HINT`](https://hint.userweb.mwn.de/hint/format.html) output format. +Although not all the texts here are written or maintained by Donald Knuth, it +is more convenient for everything to be collected in one place for reading and +searching. They all stem from the system that Knuth created. The central +entry point is the ‘index’ file, with links to the individual documents, either +in HTML or in PDF 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](https://www.tug.org/texlive). 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`](https://ctan.org/pkg/knuth-pdf) and -[`knuth-hint`](https://ctan.org/pkg/knuth-hint) packages. +If you believe to have found anything that remains technically, historically, +typographically, or politically incorrect in any of these files, please feel +free to [report bugs in \TeX\ and friends](https://tug.org/texmfbug/). -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` (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 “License” of the `knuth-pdf` package is “Public Domain” and it covers only +the contents of this package, _not_ the various (and varying) “free software” +licenses of the presented software codes. -The `pwebmac` package is free software and may be used without constraints. +In part `knuth-pdf` is an update and replacement for the `latex-tds` package. -This is version **4.12** of the `pwebmac` package — 2024-05-24, Andreas Scherer. +This is version “2.4” of the `knuth-pdf` package — 2024-07-10, Andreas Scherer. |