summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAndreas Scherer <andreas_tex@freenet.de>2020-06-11 09:49:21 +0000
committerAndreas Scherer <andreas_tex@freenet.de>2020-06-11 09:49:21 +0000
commite4ac22600ec591d9915bc233dfca8d85fb6db73a (patch)
treef77e27eceb9c9ab32bbc5ffa02d5d6f8f646631a
parent71f51f5d2057d9d4c45f1c2d5481a14126c078a3 (diff)
[CWEB] Add footnotes to cwebman.tex.
Describe the extensions in TeX Live in the form of a small set of footnotes. The major information is in the changes for appendices D--G. git-svn-id: svn://tug.org/texlive/trunk@55512 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Build/source/texk/web2c/cwebdir/ChangeLog4
-rw-r--r--Build/source/texk/web2c/cwebdir/cwebman-w2c.ch129
2 files changed, 133 insertions, 0 deletions
diff --git a/Build/source/texk/web2c/cwebdir/ChangeLog b/Build/source/texk/web2c/cwebdir/ChangeLog
index c8c84f501be..96eb7b6ff1a 100644
--- a/Build/source/texk/web2c/cwebdir/ChangeLog
+++ b/Build/source/texk/web2c/cwebdir/ChangeLog
@@ -1,3 +1,7 @@
+2020-06-11 Andreas Scherer <https://ascherer.github.io>
+
+ * cwebman-w2c.ch: Add footnotes for TeX Live extensions.
+
2020-06-10 Andreas Scherer <https://ascherer.github.io>
* ctang-w2c.ch: Add short comments to new material.
diff --git a/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch b/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
new file mode 100644
index 00000000000..4d52c68e6b5
--- /dev/null
+++ b/Build/source/texk/web2c/cwebdir/cwebman-w2c.ch
@@ -0,0 +1,129 @@
+@q Changes for CWEB in TeX Live from numerous contributors. @>
+@q This file is in the Public Domain. @>
+
+@q Most of the original Kpathsea changes by Wlodek Bzyl and Olaf Weber @>
+@q were merged with the set of change files of the CWEBbin project; @>
+@q see https://github.com/ascherer/cwebbin for the original parts. @>
+
+@q This stripped change file {comm,ctang,cweav,ctwill}-w2c.ch has been @>
+@q created from the set of change files {comm,ctang,cweav}-patch.ch, @>
+@q {comm,ctang,cweav}-ansi.ch, {comm,ctang,cweav}-extensions.ch, @>
+@q {comm,ctang,cweav}-output.ch, {comm,ctang,cweav}-i18n.ch, and @>
+@q cweav-twill.ch for CTWILL, and {comm,ctang,cweav,ctwill}-texlive.ch @>
+@q with the 'tie' processor and is used as a monolithic changefile for @>
+@q {common,ctangle,cweave}.w in TeX Live. @>
+
+@q Please send comments, suggestions, etc. to tex-k@@tug.org. @>
+
+@x
+\def\page{\box255 } \normalbottom
+@y
+\let\page=\pagebody \raggedbottom
+@z
+
+@x
+\def\runninghead{{\tentt CWEB} USER MANUAL (VERSION 3.64)}
+@y
+\def\Kpathsea/{{\mc KPATHSEA\spacefactor1000}}
+\def\runninghead{{\tentt CWEB} USER MANUAL (3.64 [\TeX~Live])}
+@z
+
+@x
+\vskip 18pt\centerline{(Version 3.64 --- February 2002)}
+@y
+\vskip 18pt\centerline{(Version 3.64 --- February 2002)%
+\footnote*{This document describes the extended \.{CWEB} (3.64 [\TeX~Live]).}}
+@z
+
+@x
+should be sent to Levy (\.{levy@math.berkeley.edu}).
+@y
+should be sent to Levy (\.{levy@math.berkeley.edu}).%
+\footnote{$^1$}{Or rather to the ``\TeX~Live''-related mailing list
+\.{tex-k@tug.org}.}
+@z
+
+@x
+email address in a \.{CWEB} file (e.g., \.{levy@@math.berkeley.edu}).
+@y
+email address in a \.{CWEB} file (e.g., \.{levy@@math.berkeley.edu}%
+\footnote{$^2$}{Or rather \.{tex-k@@tug.org}.}).
+@z
+
+@x
+it cannot find them in the current directory.
+@y
+it cannot find them in the current directory.%
+\footnote{$^3$}{In this extended implementation, if an \.{@i}nclude file can
+not be found in the current directory, \.{CWEB} will use the conventions of
+the \Kpathsea/ library as outlined in section~\X90:File lookup with
+\Kpathsea/\X~of appendix~D.}% FIXME
+@z
+
+@x
+output by \.{CWEAVE}. (On by default.) (Has no effect on \.{CTANGLE}.)
+@y
+output by \.{CWEAVE}. (On by default.) (Has no effect on \.{CTANGLE}.)%
+\footnote{$^4$}{This extended version of \.{CWEB} adds the following options
+to the list:
+
+\option i Indent parameters in function declarations. This causes the
+formal parameter declarations in function heads to be indented. (On by
+default; \.{-i} typesets declarations flush left; some people think this
+to be more logical than indenting them) (Has no effect on \.{CTANGLE}.)
+
+\option l This option takes the string of characters to its right as its
+argument to switch between different user languages and macro packages.
+For example, if you call \.{CWEAVE} with the `\.{+ld}' (or `\.{-ld}') option,
+the German \.{CWEB} macros \.{dcwebmac.tex} will be loaded in the first line
+of output instead of the English ones. To avoid conflicts, the Danish
+macros could be called \.{dkcwebmac.tex} and would be included by `\.{+ldk}'.
+(Off by default) (Has no effect on \.{CTANGLE}.)
+
+\option o Separate declarations and the first statement in a function block.
+\.{CWEAVE} automatically inserts a bit of extra space. (On by default.)
+(Has no effect on \.{CTANGLE}.)
+
+\option t Overwrite output files with temporary output only if changes occur.
+(On by default.)}
+@z
+
+@x
+appendices D, E, and~F, which exhibit the complete source code for
+\.{CTANGLE} and \.{CWEAVE}.
+
+\vfil\eject\titletrue
+@y
+appendices D, E, and~F, which exhibit the complete source code for
+\.{CTANGLE} and \.{CWEAVE}.\footnote{$^5$}{Actually, appendix~D contains the
+source code for \.{COMMON}, and the additional appendix~G exhibits the
+source code for \.{CTWILL}, which is based on \.{CWEAVE}.}
+
+\eject\titletrue
+@z
+
+@x
+ \.{ { }\\vskip 15pt \\centerline\{(Version 3.64)\}{ }\\vfill\}}\cr}$$
+@y
+ \.{ { }\\vskip 15pt \\centerline\{(Version 3.64)\}{ }\\vfill\}}\cr}$$
+@z
+
+@x
+if you have a duplex printer. Appendices D, E, and F of the complete
+@y
+if you have a duplex printer. Appendices D, E, and F\footnote{$^6$}{And
+Appendix~G.} of the complete
+@z
+
+@x
+or the \CEE/ comments of a \.{CWEB} file:
+@y
+or the \CEE/ comments of a \.{CWEB} file:%
+\footnote{$^7$}{Be careful to make that $$\vbox{\halign{\.{#}\hfil\cr
+You can send email to
+ \\pdfURL\{the author\}\{mailto:andreas\\UNDER/github@@freenet.de\}\cr
+or visit
+ \\pdfURL\{his home page\}\{https://github.com/ascherer\}\cr}}$$ in
+the $21^{\rm st}$ century.}
+@z
+