summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndreas Scherer <andreas_tex@freenet.de>2024-07-10 15:05:39 +0000
committerAndreas Scherer <andreas_tex@freenet.de>2024-07-10 15:05:39 +0000
commite240b72563e6e77ec61029e2cb9b0649dffddaf5 (patch)
tree17e6b743bffe74f3b3c1d1e5fd49ed77ba6b00e3
parent586ce2a15b699a66919cdf56b93deb13a05ff462 (diff)
[CWEB] Add link WEB manual.
Also add line numbers in cwebman-w2c.ch relative to cwebman.tex. Note that webman.pdf will have a link to the 'Holon Programming' project on Github. git-svn-id: svn://tug.org/texlive/trunk@71759 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Build/source/texk/web2c/cwebdir/ChangeLog4
-rw-r--r--Build/source/texk/web2c/cwebdir/cwebman-w2c.ch72
2 files changed, 44 insertions, 32 deletions
diff --git a/Build/source/texk/web2c/cwebdir/ChangeLog b/Build/source/texk/web2c/cwebdir/ChangeLog
index 94f43f9402d..caf15f71051 100644
--- a/Build/source/texk/web2c/cwebdir/ChangeLog
+++ b/Build/source/texk/web2c/cwebdir/ChangeLog
@@ -1,3 +1,7 @@
+2024-07-10 Andreas Scherer <https://ascherer.github.io>
+
+ * cwebman-w2c.ch: Add link to WEB manual (and line numbers).
+
2024-07-06 Andreas Scherer <https://ascherer.github.io>
* cwebman-w2c.ch: Add extra macros for HiTeX.
diff --git a/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch b/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
index fa659af4144..0b9c6156840 100644
--- a/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
+++ b/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
@@ -16,7 +16,7 @@
@q Please send comments, suggestions, etc. to tex-k@@tug.org. @>
-@x
+@x l.4
\input cwebmac
\pdffalse\acrohintfalse
@y
@@ -24,7 +24,7 @@
\ifhint \input hiplainpage \fi
@z
-@x
+@x l.6
\def\page{\box255 } \normalbottom
@y
\let\page=\pagebody \raggedbottom
@@ -33,7 +33,7 @@
\advance\footnotecount by 1\relax}
@z
-@x
+@x l.32
\outer\def\section #1.{\penalty-500\bigskip
\centerline{\sectionfont\def\.##1{{\twelvett##1}} #1}\nobreak\vskip 6pt
\everypar{\hskip-\parindent\everypar{}}}
@@ -93,21 +93,21 @@
\fi}
@z
-@x
+@x l.38
\def\runninghead{{\tentt CWEB} USER MANUAL (VERSION 4.11)}
@y
\def\Kpathsea/{{\mc KPATHSEA\spacefactor1000}}
\def\runninghead{{\tentt CWEB} USER MANUAL (Version 4.11 [\TeX~Live])}
@z
-@x
+@x l.52
\vskip 18pt\centerline{(Version 4.11 --- December 2023)}
@y
\vskip 18pt\centerline{(Version 4.11 --- December 2023)%
\footnote*{This document describes the extended \.{CWEB} (Version 4.11 [\TeX~Live]).}}
@z
-@x
+@x l.83
Internet page \.{http://www-cs-faculty.stanford.edu/\char`\~knuth/cweb.html}
@y
Internet page
@@ -115,7 +115,7 @@ Internet page
{http://www-cs-faculty.stanford.edu/\TILDE/knuth/cweb.html}
@z
-@x
+@x l.88
\.{https://github.com/ascherer/cweb} with the really current news.
@y
\pdfURL{\.{https://github.com/ascherer/cweb}}%
@@ -123,7 +123,7 @@ Internet page
with the really current news.
@z
-@x
+@x l.106
should be sent to the \TeX-related mailing list \.{tex-k@tug.org}.
@y
should be sent to the \TeX-related mailing list
@@ -131,7 +131,15 @@ should be sent to the \TeX-related mailing list
{mailto:tex-k@tug.org}.
@z
-@x
+@x l.108
+Readers who are familiar with Knuth's memo ``The \.{WEB} System of Structured
+Documentation'' will be able
+@y
+Readers who are familiar with Knuth's memo ``\pdfURL{The \.{WEB} System of
+Structured Documentation}{../web/webman.pdf}'' will be able
+@z
+
+@x l.527
email address in a \.{CWEB} file (e.g., \.{tex-k@@tug.org}).
@y
email address in a \.{CWEB} file (e.g.,
@@ -139,7 +147,7 @@ email address in a \.{CWEB} file (e.g.,
{mailto:tex-k@tug.org}).
@z
-@x
+@x l.922
it cannot find them in the current directory.
@y
it cannot find them in the current directory.%
@@ -152,7 +160,7 @@ for it.
(This is true for any other input or change file lookup.)}
@z
-@x
+@x l.1029
except for error messages.
@y
except for error messages.%
@@ -160,7 +168,7 @@ except for error messages.%
options `\.{b}', `\.{h}', and `\.{p}' are `off' by default.}
@z
-@x
+@x l.1035
options are currently implemented:
\yskip
@@ -194,7 +202,7 @@ argument to switch between different user languages and macro packages.
\yskip
@z
-@x
+@x l.1071
\option x Include indexes and a table of contents in the \TEX/ file
output by \.{CWEAVE}. (On by default.) (Has no effect on \.{CTANGLE}.)
@y
@@ -202,14 +210,14 @@ output by \.{CWEAVE}. (On by default.) (Has no effect on \.{CTANGLE}.)
output by \.{CWEAVE}. (On by default.) (\.{CWEAVE} only.)
@z
-@x
+@x l.1127
Sometimes things don't work as smoothly, and you get a bunch of
@y
\pdffalse\acrohintfalse
Sometimes things don't work as smoothly, and you get a bunch of
@z
-@x
+@x l.1135
`$\\{main}(\\{argc},\39\\{argv}{}$)'.
@y
`$\\{main}(\\{argc},\39\\{argv}{}$)'.
@@ -218,7 +226,7 @@ Sometimes things don't work as smoothly, and you get a bunch of
\ifpdf\acrohinttrue\fi \ifhint\acrohinttrue\fi
@z
-@x
+@x l.1145
the `\.{@\#}' will put extra space after `$\langle\,$Other locals$\,\rangle$'.
@y
the `\.{@\#}' will put extra space after `$\langle\,$Other locals$\,\rangle$'.%
@@ -226,14 +234,14 @@ the `\.{@\#}' will put extra space after `$\langle\,$Other locals$\,\rangle$'.%
to suppress the extra space globally.}
@z
-@x
+@x l.1147
\section Hypertext and hyperdocumentation.
@y
\vfill\eject
\section Hypertext and hyperdocumentation.
@z
-@x
+@x l.1171
from \.{https://hint.userweb.mwn.de/hint/hintview.html}.
@y
from
@@ -241,7 +249,7 @@ from
{https://hint.userweb.mwn.de/hint/hintview.html}.%
@z
-@x
+@x l.1180
the program sources at \.{ftp://ftp.cs.stanford.edu/pub/ctwill}.
@y
the program sources at
@@ -251,13 +259,13 @@ the program sources at
\.{ctwill} executable -- and its associated helpers -- out of the box.}
@z
-@x
+@x l.1184
As an example of a real program written in \.{CWEB}, Appendix~A
@y
As an example of a real program written in \.{CWEB}, \Appendix A
@z
-@x
+@x l.1189
Appendix B displays the files that set \TEX/ up to accept
the output of \.{CWEAVE}, and Appendix~C discusses how to use some of those
@y
@@ -265,7 +273,7 @@ the output of \.{CWEAVE}, and Appendix~C discusses how to use some of those
the output of \.{CWEAVE}, and \Appendix C discusses how to use some of those
@z
-@x
+@x l.1195
appendices D, E, and~F, which exhibit the complete source code for
\.{CTANGLE} and \.{CWEAVE}.
@@ -281,7 +289,7 @@ exhibits the source code for \.{CTWILL}, which is based on \.{CWEAVE}.}
\eject\titletrue
@z
-@x
+@x l.1201
\section Appendix A: Excerpts from a \.{CWEB} Program.
@y
\def\subsections{4}
@@ -289,28 +297,28 @@ exhibits the source code for \.{CTWILL}, which is based on \.{CWEAVE}.}
\subsection CWEB file format.
@z
-@x
+@x l.1205
generated sections 27--31 of the file \.{common.w}, which contains
@y
generated sections 27--31 of the file
\pdfURL{\.{common.w}}{common.pdf}, which contains
@z
-@x
+@x l.1276
\def\runninghead{APPENDIX A --- TRANSLATION BY {\tentt CTANGLE}}
@y
\def\runninghead{APPENDIX A --- TRANSLATION BY {\tentt CTANGLE}}
\subsection Translation by CTANGLE.
@z
-@x
+@x l.1344
\def\runninghead{APPENDIX A --- TRANSLATION BY {\tentt CWEAVE}}
@y
\def\runninghead{APPENDIX A --- TRANSLATION BY {\tentt CWEAVE}}
\subsection Translation by CWEAVE.
@z
-@x
+@x l.1433
\def\runninghead{APPENDIX A --- FINAL DOCUMENT}
And here's what the same excerpt looks like when typeset.
@@ -327,7 +335,7 @@ And here's what the same excerpt looks like when typeset.
\def\C#1{\5\5\quad$\triangleright\,${\cmntfont#1}$\,\triangleleft$}
@z
-@x
+@x l.1515
\vfil\eject\titletrue
@y
\vfil\eject\titletrue
@@ -336,13 +344,13 @@ And here's what the same excerpt looks like when typeset.
\ifacro\acrohinttrue\fi \ifhint\acrohinttrue\fi
@z
-@x
+@x l.1617
\.{ { }\\vskip 15pt \\centerline\{(Version 4.11)\}{ }\\vfill\}}\cr}$$
@y
\.{ { }\\vskip 15pt \\centerline\{(Version 4.11)\}{ }\\vfill\}}\cr}$$
@z
-@x
+@x l.1732
if you have a duplex printer. Appendices D, E, and F of the complete
version of this manual are printed using a commented-out option that
substitutes `$\gets$' for `$=$' in the program listings. Looking at those
@@ -356,14 +364,14 @@ also make use of the alternative format for \CEE/ comments.}
Looking at those
@z
-@x
+@x l.1784
\point 20. Furthermore, group titles can be converted to an arbitrary
@y
\vfill\eject
\point 20. Furthermore, group titles can be converted to an arbitrary
@z
-@x
+@x l.1796
\vfill\end
@y
\point 21. With modern \TeX\ engines like `\.{luatex}', `\.{pdftex}', and