summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/plain
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-03-08 18:34:16 +0000
committerKarl Berry <karl@freefriends.org>2021-03-08 18:34:16 +0000
commita96eb9f8ff905f4cb1c3f908700d8f8e6dbb4c2e (patch)
treef9711622911ec8b5fbb140606230ae4f1e6653c7 /Master/texmf-dist/doc/plain
parentb8bbb5c4096ec141403ff5e06e55c25eb7f3c805 (diff)
pwebmac, minus knuth-lib tarball
git-svn-id: svn://tug.org/texlive/trunk@58226 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/plain')
-rw-r--r--Master/texmf-dist/doc/plain/pwebmac/README.TEXLIVE9
-rw-r--r--Master/texmf-dist/doc/plain/pwebmac/README.md6
-rw-r--r--Master/texmf-dist/doc/plain/pwebmac/index.md2
-rw-r--r--Master/texmf-dist/doc/plain/pwebmac/makeall14
-rw-r--r--Master/texmf-dist/doc/plain/pwebmac/trapman.ch23
-rw-r--r--Master/texmf-dist/doc/plain/pwebmac/webman.ch198
6 files changed, 249 insertions, 3 deletions
diff --git a/Master/texmf-dist/doc/plain/pwebmac/README.TEXLIVE b/Master/texmf-dist/doc/plain/pwebmac/README.TEXLIVE
new file mode 100644
index 00000000000..ee57a709adb
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/pwebmac/README.TEXLIVE
@@ -0,0 +1,9 @@
+The files below have been removed in the TeX Live installation of
+the current package, possibly because of missing source (e.g., a
+PDF with no source), possibly because their only purpose is to support
+nonfree fonts or other software, possibly for other reasons.
+More info: https://tug.org/texlive/pkgcontrib.html#requirements
+
+If this is a concern, please contact the package maintainer.
+
+ knuth-lib.tar.gz
diff --git a/Master/texmf-dist/doc/plain/pwebmac/README.md b/Master/texmf-dist/doc/plain/pwebmac/README.md
index 5c3399b280b..cfd345d978b 100644
--- a/Master/texmf-dist/doc/plain/pwebmac/README.md
+++ b/Master/texmf-dist/doc/plain/pwebmac/README.md
@@ -3,8 +3,8 @@
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
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 [pdfTeX](https://ctan.org/pkg/pdftex).
+Hàn Thế Thành has modified 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 _modify_ `webmac.tex` for PDF output;
these macros can only be used with a specific “TeX engine” each.
@@ -29,4 +29,4 @@ clickable links and bookmarks (depending on your PDF viewer).
The `pwebmac` package is free software and may be used without constraints.
-This is version “4.5.7” of the `pwebmac` package — 2021-02-11, AS.
+This is version “4.6” of the `pwebmac` package — 2021-03-01, AS.
diff --git a/Master/texmf-dist/doc/plain/pwebmac/index.md b/Master/texmf-dist/doc/plain/pwebmac/index.md
index b7584641ce9..e80680479c7 100644
--- a/Master/texmf-dist/doc/plain/pwebmac/index.md
+++ b/Master/texmf-dist/doc/plain/pwebmac/index.md
@@ -1,6 +1,8 @@
---
title: C/WEB programs in “\TeX\ Live 2021”
colorlinks: true
+filecolor: blue
+urlcolor: blue
---
\raggedright
\vspace{-2\baselineskip}
diff --git a/Master/texmf-dist/doc/plain/pwebmac/makeall b/Master/texmf-dist/doc/plain/pwebmac/makeall
index b67a8af1540..fbe95ae54d7 100644
--- a/Master/texmf-dist/doc/plain/pwebmac/makeall
+++ b/Master/texmf-dist/doc/plain/pwebmac/makeall
@@ -235,6 +235,11 @@ FI
then $f $f # run TeX twice
else $TEX $f # run TeX twice
fi
+
+ # run TEX.WEB three times to fix table-of-contents
+ if [ tex = $f ]
+ then $TEX $f
+ fi
fi
# only XeTeX can process XETEX.WEB
@@ -353,6 +358,15 @@ then
$PAX "$OUTDIR/cweb.tar.gz" -s ,^,cweb/, \
cwebman.pdf common.pdf ctangle.pdf cweave.pdf ctwill.pdf
fi
+
+ # Notes to self:
+ # (1) Create a user-friendly central entrypoint with
+ # (a) pandoc index.md -o index.pdf
+ # (b) pandoc index.md -o index.tex;
+ # pandoc index.tex -s -o index.html;
+ # rm index.tex
+ # (2) Prepare a super-tarball from all the contents of these
+ # individual tarballs with 'pax -wzf knuth-lib.tar.gz'.
fi
exit 0
diff --git a/Master/texmf-dist/doc/plain/pwebmac/trapman.ch b/Master/texmf-dist/doc/plain/pwebmac/trapman.ch
new file mode 100644
index 00000000000..2467983cfef
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/pwebmac/trapman.ch
@@ -0,0 +1,23 @@
+@x l.355
+\verbatim{trapin.log}
+@y
+\verbatim{mftrapin.log}
+@z
+
+@x l.365
+\verbatim{trap.log}
+@y
+\verbatim{mftrap.log}
+@z
+
+@x l.389
+\verbatim{trap.pl}
+@y
+\verbatim{mftrap.pl}
+@z
+
+@x l.398
+\verbatim{trap.fot}
+@y
+\verbatim{mftrap.fot}
+@z
diff --git a/Master/texmf-dist/doc/plain/pwebmac/webman.ch b/Master/texmf-dist/doc/plain/pwebmac/webman.ch
new file mode 100644
index 00000000000..af8b2e88ff2
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/pwebmac/webman.ch
@@ -0,0 +1,198 @@
+@x l.2
+\input webmac
+@y
+\input pwebmac
+\ifacro
+ \pdfpagewidth=\pagewidth \advance\pdfpagewidth by 2cm
+ \pdfpageheight=\pageheight \advance\pdfpageheight by 3cm
+ \ifpdftex \pdfhorigin=1cm \pdfvorigin=1cm
+ \else \advance\pdfpageheight by 1cm \global\pageshift=-1.54cm
+ \global\hoffset=-1.54cm \global\voffset=-1.54cm \fi
+\else\pageno=1\fi
+@z
+
+@x l.16
+\outer\def\section #1.{\penalty-50\vskip 12pt plus 3pt minus 3pt
+ \noindent{\bf #1.}\quad\ignorespaces}
+@y
+\newcount\destcount \destcount=1\relax
+
+\def\bkminfo{}
+\outer\def\section #1.{\penalty-50\vskip 12pt plus 3pt minus 3pt
+ \noindent\ifacro\vbox to 0pt{\kern-2.5ex\relax
+ \ifpdftex\pdfdest num \destcount fitbh\relax
+ \else\special{pdf: dest (\the\destcount) [ @thispage /FitBH @ypos ]}\fi
+ \def\.##1{##1}%
+ \ifx\bkminfo\empty\def\sectitle{#1}\else\def\sectitle{#1 (\bkminfo)}\fi
+ \ifpdftex\pdfoutline goto num \destcount {\sectitle}\relax
+ \else\special{pdf: outline 0 << /Title (\sectitle)
+ /A << /S /GoTo /D (\the\destcount) >> >>}\fi
+ \gdef\bkminfo{}%
+ \global\advance\destcount by 1\relax
+ \kern2.5ex\relax
+ }\fi{\bf #1.}\quad\ignorespaces}
+
+\def\appA{7}
+\def\appB{8}
+\def\appC{9}
+\def\appD{0}
+\def\appE{0}
+\def\appF{10}
+\def\appG{11}
+\def\appH{12}
+
+\def\Appendix#1{\leavevmode
+ \ifnum\csname app#1\endcsname>0 %
+ \ifacro\ifpdftex
+ \pdfstartlink attr{/Border[0 0 0]} goto num\csname app#1\endcsname\relax
+ \PDFlinkcolor\hbox{Appendix}~#1\Black
+ \pdfendlink
+ \else
+ \setbox0=\hbox{\special{pdf: bc [ \pdflinkcolor ]}{\hbox{Appendix}~#1}%
+ \special{pdf: ec}}\special{pdf: ann width \thewidth height \theheight
+ depth \thedepth << /Type /Annot /Subtype /Link /Border [0 0 0]
+ /A << /S /GoTo /D (\csname app#1\endcsname) >> >>}\box0\relax
+ \fi\else Appendix~#1\fi
+ \else Appendix~#1\fi}
+@z
+
+@x
+program for \.{TANGLE}, in the appendix, gives precise details about this
+@y
+program for \.{TANGLE}, in \pdfURL{Appendix~E}{tangle.pdf},
+gives precise details about this
+@z
+
+@x l.626
+outputs of \.{WEAVE} and \.{TANGLE} (see Appendix~C\null). Meta-comments
+@y
+outputs of \.{WEAVE} (see \Appendix B\null) and \.{TANGLE}
+(see \Appendix C\null). Meta-comments
+@z
+
+@x l.893
+examples of ``real'' programs. Appendix~A shows the \.{WEB} input that
+generated modules 55--59 of the \.{WEAVE} program; Appendix~B shows the
+corresponding \TeX\ code output by \.{WEAVE}; and Appendix~C shows excerpts
+@y
+examples of ``real'' programs. \Appendix A shows the \.{WEB} input that
+generated modules 55--59 of the \.{WEAVE} program; \Appendix B shows the
+corresponding \TeX\ code output by \.{WEAVE}; and \Appendix C shows excerpts
+@z
+
+@x l.900
+report, in Appendices D and~E. The reader should first compare Appendix~A
+to the corresponding portion of Appendix~D; then the same material should
+be compared to Appendices B and~C. Finally, if time permits, the reader may
+enjoy studying the complete programs in Appendices D and~E, since \.{WEAVE}
+@y
+report, in Appendices \pdfURL{D}{weave.pdf} and~\pdfURL{E}{tangle.pdf}.
+The reader should first compare \Appendix A to the corresponding portion of
+\pdfURL{Appendix~D}{weave.pdf}; then the same material should be compared to
+\Appendix B and \Appendix C. Finally, if time permits, the reader may enjoy
+studying the complete programs in Appendices \pdfURL{D}{weave.pdf}
+and~\pdfURL{E}{tangle.pdf}, since \.{WEAVE}
+@z
+
+@x l.908
+Finally, Appendix F is the `\.{webmac}' file that sets \TeX\ up to accept
+the output of \.{WEAVE}; Appendix~G discusses how to use some of its macros
+to vary the output formats; and Appendix~H discusses what needs to be done
+@y
+Finally, \Appendix F is the `\.{webmac}' file that sets \TeX\ up to accept
+the output of \.{WEAVE}; \Appendix G discusses how to use some of its macros
+to vary the output formats; and \Appendix H discusses what needs to be done
+@z
+
+@x l.913
+The programs in Appendices D and E will optionally keep statistics on
+@y
+The programs in Appendices \pdfURL{D}{weave.pdf} and \pdfURL{E}{tangle.pdf}
+will optionally keep statistics on
+@z
+
+@x l.989
+\section Appendix A.
+This excerpt from \.{WEAVE.WEB} produced modules 55--59 in Appendix~D.
+@y
+\def\bkminfo{WEB file format}
+\section Appendix A.
+This excerpt from \.{WEAVE.WEB} produced modules 55--59 in
+\pdfURL{Appendix~D}{weave.pdf}.
+@z
+
+@x l.1061
+\section Appendix B.
+This excerpt from \.{WEAVE.TEX} corresponds to Appendix A.
+@y
+\def\bkminfo{Translations by WEAVE}
+\section Appendix B.
+This excerpt from \.{WEAVE.TEX} corresponds to \Appendix A.
+@z
+
+@x l.1143
+\section Appendix C.
+@y
+\def\bkminfo{Translation by TANGLE}
+\section Appendix C.
+@z
+
+@x l.1425
+in small caps. For example, Appendix~D was produced after saying
+@y
+in small caps. For example, \pdfURL{Appendix~D}{weave.pdf} was produced
+after saying
+@z
+
+@x l.1468
+\.{\\pageno=\\contentspagenumber} \.{\\advance\\pageno by 1}'. (Appendix~D
+@y
+\.{\\pageno=\\contentspagenumber} \.{\\advance\\pageno by 1}'.
+(\pdfURL{Appendix~D}{weave.pdf}
+@z
+
+@x l.1479
+For example, Appendix~D was produced with the following definitions:
+@y
+For example, \pdfURL{Appendix~D}{weave.pdf} was produced with the following
+definitions:
+@z
+
+@x l.1491
+for every starred module. For example, when Appendix~D was being generated,
+@y
+for every starred module. For example, when \pdfURL{Appendix~D}{weave.pdf}
+was being generated,
+@z
+
+@x l.1583
+dependencies'' in the index of Appendix~E above, and figure out what changes
+@y
+dependencies'' in the index of \pdfURL{Appendix~E}{tangle.pdf} above,
+and figure out what changes
+@z
+
+@x l.1609
+the index to Appendix~D.
+@y
+the index to \pdfURL{Appendix~D}{weave.pdf}.
+@z
+
+@x l.1616
+Appendix~E. This listing will incorporate your changes.
+@y
+\pdfURL{Appendix~E}{tangle.pdf}. This listing will incorporate your changes.
+@z
+
+@x l.1620
+Appendix~D that incorporates your changes.
+@y
+\pdfURL{Appendix~D}{weave.pdf} that incorporates your changes.
+@z
+
+@x l.1666
+computer by following Appendices D and E. Then you have to simulate the
+@y
+computer by following Appendices \pdfURL{D}{weave.pdf}
+and~\pdfURL{E}{tangle.pdf}. Then you have to simulate the
+@z