summaryrefslogtreecommitdiff
path: root/info
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2024-07-11 03:01:39 +0000
committerNorbert Preining <norbert@preining.info>2024-07-11 03:01:39 +0000
commit2060043b2a5921ac96e4c0c84215e5bfb5d6388b (patch)
tree5dec1755e30762cd08064ad6ef5308d4690bdd09 /info
parent835d1c8d3de2b2316395e9613def9ca693c485c1 (diff)
CTAN sync 202407110301
Diffstat (limited to 'info')
-rw-r--r--info/knuth-hint/README.md2
-rw-r--r--info/knuth-pdf/README.md55
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.