summaryrefslogtreecommitdiff
path: root/Build/source/texk/web2c/man
diff options
context:
space:
mode:
authorAndreas Scherer <andreas_tex@freenet.de>2021-05-03 13:03:46 +0000
committerAndreas Scherer <andreas_tex@freenet.de>2021-05-03 13:03:46 +0000
commit60712e2174bfaa66828692206c37af9b20d9fc9a (patch)
tree3e9284ecd37b56a42a67118bb5aa94482e07112b /Build/source/texk/web2c/man
parentd3de05fb9dda5d710a51f3ad2097d67d8452a166 (diff)
[CWEB] New release 4.3.1.
This release is almost the same as CWEB 4.3 of 2021-04-16, but * it fixes the indexing bug in CWEAVE/CTWILL that got retracted * it extracts and collects all additions made in CTWILL, so that the section numbers of CWEAVE are retained up to ยง272 and new material is described in the (first) appendix, including the CTWILL user manual * it provides fully revised and (hopefully) corrected mini-indexes for CTWILL, if it is processed by itself (to be published in package 'knuth-pdf' on CTAN) git-svn-id: svn://tug.org/texlive/trunk@59061 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c/man')
-rw-r--r--Build/source/texk/web2c/man/ChangeLog9
-rw-r--r--Build/source/texk/web2c/man/ctwill.man29
-rw-r--r--Build/source/texk/web2c/man/cweb.man25
3 files changed, 43 insertions, 20 deletions
diff --git a/Build/source/texk/web2c/man/ChangeLog b/Build/source/texk/web2c/man/ChangeLog
index 0808c91d136..972b6227722 100644
--- a/Build/source/texk/web2c/man/ChangeLog
+++ b/Build/source/texk/web2c/man/ChangeLog
@@ -1,3 +1,12 @@
+2021-04-13 Andreas Scherer <https://ascherer.github.io>
+
+ * ctwill.man,
+ * cweb.man: CWEB 4.3 release.
+
+2021-03-07 Andreas Scherer <https://ascherer.github.io>
+
+ * ctwill.man: Document 'ctwill-twinx' a bit more.
+
2021-03-04 Karl Berry <karl@freefriends.org>
* gftodvi.man: font and spacing fixes from Debian.
diff --git a/Build/source/texk/web2c/man/ctwill.man b/Build/source/texk/web2c/man/ctwill.man
index c000d7dc088..0601bfd42ab 100644
--- a/Build/source/texk/web2c/man/ctwill.man
+++ b/Build/source/texk/web2c/man/ctwill.man
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 2.11.4
+.\" Automatically generated by Pandoc 2.12
.\"
-.TH "CTWILL" "1" "February 6, 2021" "Web2c @VERSION@" "General Commands Manual"
+.TH "CTWILL" "1" "April 24, 2021" "Web2c @VERSION@" "General Commands Manual"
.hy
.SH NAME
.PP
@@ -48,7 +48,7 @@ If you just want to change the output file name, but don\[cq]t have a
change file to apply, you can use `\f[B]-\f[R]' as the second argument.
.PP
\f[B]ctwill\f[R] is exactly like \f[B]cweave\f[R] except that it
-produces much better documentation, for which you must work harder.
+produces much better documentation, for which you must work much harder.
You should run \f[B]ctwill\f[R] twice, once to prime the pump and once
to get decent answers.
Moreover, you must run the output twice through TeX.
@@ -60,9 +60,14 @@ Say \f[B]ctwill-refsort < foo.ref > foo.sref\f[R] and then another \f[B]tex
foo\f[R] will produce alphabetized output.
.PP
The \f[B]ctwill-twinx\f[R] program compiles a master index for a set of related
-programs that have been processed by \f[B]ctwill\f[R].
+programs that have been processed by \f[B]ctwill\f[R] (\f[I]not\f[R] by
+\f[B]cweave\f[R], mind you!).
The individual programs should define their names with a line of the
form \f[B]\[rs]def\[rs]title{NAME}\f[R].
+For your convenience, \f[B]ctwill-twinx\f[R] grabs the first \[lq]word\[rq] in
+\f[B]\[rs]title\f[R] and turns it into uppercase form.
+You should adapt file \f[B]twinx-startup.tex\f[R] for the first page of
+the master index.
.PP
The mini-indexes list identifiers that are used but not defined on each
two-page spread.
@@ -106,13 +111,13 @@ The present incarnation of \f[B]ctwill\f[R] and its utilities tries hard
to be a drop-in replacement for the original package.
There are, however, a few differences worth noting:
.IP \[bu] 2
-This version is based on the most recent version of CWEB (4.2).
+This version is based on the most recent version of CWEB (4.3).
.IP \[bu] 2
In TeX\ Live the utility programs are prefixed with \f[B]ctwill-\f[R]
and the macro files with \f[B]ct\f[R] for technical reasons.
.IP \[bu] 2
Options \f[B]--help\f[R], \f[B]--quiet\f[R], \f[B]--verbose\f[R],
-\f[B]--version\f[R], and flags \f[B]-i\f[R], \f[B]-o\f[R], \f[B]-t\f[R],
+\f[B]--version\f[R], and flags \f[B]-c\f[R], \f[B]-i\f[R], \f[B]-o\f[R],
and \f[B]+lX\f[R] are new in CWEBbin and TeX\ Live.
.IP \[bu] 2
Option \f[B]+lX\f[R] is accompanied by example wrapper files for
@@ -153,6 +158,8 @@ leave out the \f[B]happy message\f[R] (\f[B]-h\f[R]).
\f[B]+v\f[R]/\f[B]-v\f[R]: shortcut for \f[B]+bhp\f[R]; also
\f[B]--verbose\f[R]
.IP \[bu] 2
+\f[B]-c\f[R]: ignore temporary output irrespective of changes
+.IP \[bu] 2
\f[B]-e\f[R]: do not enclose C/C++\ material in \f[B]\[rs]PB{\&...}\f[R]
.IP \[bu] 2
\f[B]-f\f[R]: do not force a newline after every C/C++\ statement in
@@ -162,8 +169,6 @@ output
.IP \[bu] 2
\f[B]-o\f[R]: suppress separation of declarations and statements
.IP \[bu] 2
-\f[B]-t\f[R]: ignore temporary output irrespective of changes
-.IP \[bu] 2
\f[B]-x\f[R]: omit indices, section names, table of contents
.IP \[bu] 2
\f[B]+P\f[R]: \f[B]\[rs]input ctproofmac.tex\f[R] instead of
@@ -174,6 +179,9 @@ output
.IP \[bu] 2
\f[B]+s\f[R]: print usage statistics
.IP \[bu] 2
+\f[B]+t\f[R]: treat \f[B]typename\f[R] in a template like
+\f[B]typedef\f[R]
+.IP \[bu] 2
\f[B]--help\f[R]: display help message and exit
.IP \[bu] 2
\f[B]--version\f[R]: output version information and exit
@@ -246,7 +254,4 @@ Levy and Knuth.
.PD 0
.P
.PD
-\f[B]ctwill\f[R] and its utilities \f[B]ctwill-refsort\f[R] and \f[B]ctwill-twinx\f[R]
-have been fully integrated with the CWEBbin extension that serves as the
-basis for CWEB in TeX\ Live; see the project
-page (https://github.com/ascherer/cwebbin).
+Contemporary development on https://github.com/ascherer/cwebbin.
diff --git a/Build/source/texk/web2c/man/cweb.man b/Build/source/texk/web2c/man/cweb.man
index 1786b698e8a..b5e1c28cb47 100644
--- a/Build/source/texk/web2c/man/cweb.man
+++ b/Build/source/texk/web2c/man/cweb.man
@@ -1,6 +1,6 @@
-.\" Automatically generated by Pandoc 2.11.4
+.\" Automatically generated by Pandoc 2.12
.\"
-.TH "CWEB" "1" "September 23, 2020" "Web2c @VERSION@" "General Commands Manual"
+.TH "CWEB" "1" "April 24, 2021" "Web2c @VERSION@" "General Commands Manual"
.hy
.SH NAME
.PP
@@ -55,7 +55,7 @@ the resulting output.
There are, however, a few differences worth noting:
.IP \[bu] 2
Options \f[B]--help\f[R], \f[B]--quiet\f[R], \f[B]--verbose\f[R],
-\f[B]--version\f[R], and flags \f[B]-i\f[R], \f[B]-o\f[R], \f[B]-t\f[R],
+\f[B]--version\f[R], and flags \f[B]-c\f[R], \f[B]-i\f[R], \f[B]-o\f[R],
and \f[B]+lX\f[R] are new in CWEBbin and TeX\ Live.
.IP \[bu] 2
Option \f[B]+lX\f[R] is accompanied by several wrapper files for
@@ -95,15 +95,19 @@ The first batch of options are common to both \f[B]ctangle\f[R] and
\f[B]+v\f[R]/\f[B]-v\f[R]: shortcut for \f[B]+bhp\f[R]; also
\f[B]--verbose\f[R]
.IP \[bu] 2
-\f[B]+s\f[R]: print usage statistics
+\f[B]-c\f[R]: ignore temporary output irrespective of changes
.IP \[bu] 2
-\f[B]-t\f[R]: ignore temporary output irrespective of changes
+\f[B]+s\f[R]: print usage statistics
.IP \[bu] 2
\f[B]--help\f[R]: display help message and exit
.IP \[bu] 2
\f[B]--version\f[R]: output version information and exit
.PP
-There are six other options applicable to \f[B]cweave\f[R] only:
+There is one other option applicable to \f[B]ctangle\f[R] only:
+.IP \[bu] 2
+\f[B]+k\f[R]: keep separators in numeric literals in the output
+.PP
+There are seven other options applicable to \f[B]cweave\f[R] only:
.IP \[bu] 2
\f[B]-e\f[R]: do not enclose C/C++\ material in \f[B]\[rs]PB{\&...}\f[R]
.IP \[bu] 2
@@ -118,6 +122,9 @@ output
.IP \[bu] 2
\f[B]+lX\f[R]/\f[B]-lX\f[R]: use macros for language \f[I]X\f[R] as of
\f[I]X\f[R]\f[B]cwebmac.tex\f[R]
+.IP \[bu] 2
+\f[B]+t\f[R]: treat \f[B]typename\f[R] in a template like
+\f[B]typedef\f[R]
.SH ENVIRONMENT
.PP
The environment variable CWEBINPUTS is used to search for the input
@@ -165,9 +172,11 @@ Don Knuth wrote WEB for TeX and Pascal.
Silvio Levy designed and developed CWEB by adapting the WEB conventions
to C and by recoding everything in CWEB.
Knuth began using CWEB and made further refinements.
+.PD 0
+.P
+.PD
Many other helpers are acknowledged in the CWEB manual.
.PD 0
.P
.PD
-CWEB in TeX\ Live is based on the CWEBbin extension; see the project
-page (https://github.com/ascherer/cwebbin).
+Contemporary development on https://github.com/ascherer/cweb.