Skip to content

Commit

Permalink
[CWEB] Add link WEB manual.
Browse files Browse the repository at this point in the history 
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/Build/source@71759 c570f23f-e606-0410-a88d-b1316a301751
  • Loading branch information
Andreas Scherer committed Jul 10, 2024
1 parent c087bab commit af807ee
Show file tree
Hide file tree
Showing 2 changed files with 44 additions and 32 deletions.
4 changes: 4 additions & 0 deletions texk/web2c/cwebdir/ChangeLog
View file
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
72 changes: 40 additions & 32 deletions texk/web2c/cwebdir/cwebman-w2c.ch
View file
Original file line number Diff line number Diff line change
Expand Up @@ -16,15 +16,15 @@

@q Please send comments, suggestions, etc. to tex-k@@tug.org. @>

@x
@x l.4
\input cwebmac
\pdffalse\acrohintfalse
@y
\input cwebmac
\ifhint \input hiplainpage \fi
@z

@x
@x l.6
\def\page{\box255 } \normalbottom
@y
\let\page=\pagebody \raggedbottom
Expand All @@ -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{}}}
Expand Down Expand Up @@ -93,53 +93,61 @@
\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
\pdfURL{\.{http://www-cs-faculty.stanford.edu/\char`\~knuth/cweb.html}}%
{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}}%
{https://github.com/ascherer/cweb}
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
\pdfURL{\.{tex-k@tug.org}}%
{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.,
\pdfURL{\.{tex-k@@tug.org}}%
{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.%
Expand All @@ -152,15 +160,15 @@ 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.%
\cwebfootnote{\.{CWEB} in \TeX~Live runs `\.{--quiet}ly', i.\,e.,
options `\.{b}', `\.{h}', and `\.{p}' are `off' by default.}
@z
@x
@x l.1035
options are currently implemented:
\yskip
Expand Down Expand Up @@ -194,22 +202,22 @@ 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
\option x Include indexes and a table of contents in the \TEX/ file
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}{}$)'.
Expand All @@ -218,30 +226,30 @@ 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$'.%
\cwebfootnote{This extended version of \.{CWEB} acknowledges the \.{-o} option
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
\pdfURL{\.{https://hint.userweb.mwn.de/hint/hintview.html}}%
{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
Expand All @@ -251,21 +259,21 @@ 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
\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
@z
@x
@x l.1195
appendices D, E, and~F, which exhibit the complete source code for
\.{CTANGLE} and \.{CWEAVE}.
Expand All @@ -281,36 +289,36 @@ 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}
\section Appendix A: Excerpts from a \.{CWEB} Program.
\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.
Expand All @@ -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
Expand All @@ -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
Expand All @@ -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
Expand Down

0 comments on commit af807ee

Please sign in to comment.