texlive[61546] Build/source/texk/web2c: [WEB] Add TWILL manpage.
commits+ascherer at tug.org
commits+ascherer at tug.org
Sun Jan 9 11:40:51 CET 2022
Revision: 61546
http://tug.org/svn/texlive?view=revision&revision=61546
Author: ascherer
Date: 2022-01-09 11:40:50 +0100 (Sun, 09 Jan 2022)
Log Message:
-----------
[WEB] Add TWILL manpage.
We also rename the macros to 'twimac-web.tex' in order
to distinguish them from DEK's original 'twimac.tex' on CTAN
(https://mirrors.ctan.org/systems/knuth/local/lib/twimac.tex),
which is specifically designed for Volumes B and D of
"Computers & Typesetting".
Modified Paths:
--------------
trunk/Build/source/texk/web2c/ChangeLog
trunk/Build/source/texk/web2c/help.h
trunk/Build/source/texk/web2c/man/ChangeLog
trunk/Build/source/texk/web2c/man/weave.man
trunk/Build/source/texk/web2c/weav-twill.ch
Added Paths:
-----------
trunk/Build/source/texk/web2c/man/twill.man
Modified: trunk/Build/source/texk/web2c/ChangeLog
===================================================================
--- trunk/Build/source/texk/web2c/ChangeLog 2022-01-09 00:49:24 UTC (rev 61545)
+++ trunk/Build/source/texk/web2c/ChangeLog 2022-01-09 10:40:50 UTC (rev 61546)
@@ -1,3 +1,8 @@
+2022-01-09 Andreas Scherer <https://ascherer.github.io>
+
+ * help.h,
+ * weav-twill.ch: Minor adaptions for TWILL.
+
2022-01-07 Karl Berry <karl at freefriends.org>
* (MFTHELP): consistent argument names. Report from
Modified: trunk/Build/source/texk/web2c/help.h
===================================================================
--- trunk/Build/source/texk/web2c/help.h 2022-01-09 00:49:24 UTC (rev 61545)
+++ trunk/Build/source/texk/web2c/help.h 2022-01-09 10:40:50 UTC (rev 61546)
@@ -642,7 +642,7 @@
#ifdef TWILL
const_string TWILLHELP[] = {
"Usage: twill [OPTION]... WEBFILE[.web] [CHANGEFILE[.ch]]",
- " Weave WEBFILE with CHANGEFILE into a TeX document.",
+ " Weave WEBFILE with CHANGEFILE into a TeX document with mini-indexes.",
" Default CHANGEFILE is " DEV_NULL ";",
" TeX output goes to the basename of WEBFILE extended with `.tex'.",
"",
Modified: trunk/Build/source/texk/web2c/man/ChangeLog
===================================================================
--- trunk/Build/source/texk/web2c/man/ChangeLog 2022-01-09 00:49:24 UTC (rev 61545)
+++ trunk/Build/source/texk/web2c/man/ChangeLog 2022-01-09 10:40:50 UTC (rev 61546)
@@ -1,3 +1,8 @@
+2022-01-09 Andreas Scherer <https://ascherer.github.io>
+
+ * twill.man,
+ * weave.man:New manpage for TWILL.
+
2021-12-26 Andreas Scherer <https://ascherer.github.io>
* ctwill.man: CWEB 4.6 release.
Copied: trunk/Build/source/texk/web2c/man/twill.man (from rev 61535, trunk/Build/source/texk/web2c/man/weave.man)
===================================================================
--- trunk/Build/source/texk/web2c/man/twill.man (rev 0)
+++ trunk/Build/source/texk/web2c/man/twill.man 2022-01-09 10:40:50 UTC (rev 61546)
@@ -0,0 +1,75 @@
+.TH WEAVE 1 "09 January 2022" "Web2C @VERSION@"
+.\"=====================================================================
+.if n .ds MF Metafont
+.if t .ds MF Metafont
+.if n .ds TX TeX
+.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
+.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP
+.el .ds OX TeX
+.\" BX definition must follow TX so BX can use TX
+.if n .ds BX BibTeX
+.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
+.\" LX definition must follow TX so LX can use TX
+.if n .ds LX LaTeX
+.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
+.if n .ds WB Web
+.if t .ds WB W\s-2EB\s0
+.\"=====================================================================
+.SH NAME
+twill \- translate WEB to TeX
+.SH SYNOPSIS
+.B twill
+.RB [ \-x ]
+.IR webfile [ \fB.web\fP ]
+.RI [ changefile [ \fB.ch\fP ]]
+.\"=====================================================================
+.SH DESCRIPTION
+The
+.B twill
+program is used to create a \*(TX file for viewing a \*(WB program.
+It takes appropriate care of typographic details like page
+layout and the use of indentation, italics, boldface, etc., and it supplies
+extensive cross-index information in the form of 'mini-indexes' for each
+spread of pages and a 'master index' at the end that it gathers automatically.
+.PP
+The command line arguments are the same as for
+.B tangle
+except for the option:
+.B \-x
+says to omit the indexes, module name list, and table of contents pages.
+(A
+.I CONTENTS.tex
+file will still be written when the \*(TX file is processed,
+however, unless some macros in
+.I webmac.tex
+are redefined.)
+.PP
+The output \*(TX file name is formed by adding
+.B .tex
+to the root of the \*(WB file name.
+.PP
+There are several macros
+that probably should be redefined by
+the programmer at the beginning of the \*(WB file.
+It is a good idea to set \\title
+to the name of the program.
+And, to cause output of only changed modules, one can say
+\\let\\maybe=\\iffalse (usually as the first change in the
+change file).
+.\"=====================================================================
+.SH ENVIRONMENT
+The environment variable WEBINPUTS is used to search for the input files,
+or the system default if WEBINPUTS is not set. See
+.BR tex (1)
+for the details of the searching.
+.\"=====================================================================
+.SH FILES
+.TP \w'@@'u+2n
+.I $TEXMFMAIN/tex/plain/knuth-lib/twimac-web.tex
+\*(TX macros used by
+.B twill
+output.
+.\"=====================================================================
+.SH "SEE ALSO"
+.BR tangle (1)
+for references, authors, and other information.
Modified: trunk/Build/source/texk/web2c/man/weave.man
===================================================================
--- trunk/Build/source/texk/web2c/man/weave.man 2022-01-09 00:49:24 UTC (rev 61545)
+++ trunk/Build/source/texk/web2c/man/weave.man 2022-01-09 10:40:50 UTC (rev 61546)
@@ -1,4 +1,4 @@
-.TH WEAVE 1 "16 June 2015" "Web2C @VERSION@"
+.TH WEAVE 1 "09 January 2022" "Web2C @VERSION@"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
@@ -68,7 +68,7 @@
.\"=====================================================================
.SH FILES
.TP \w'@@'u+2n
-.I $TEXMFMAIN/tex/plain/base/webmac.tex
+.I $TEXMFMAIN/tex/plain/knuth-lib/webmac.tex
\*(TX macros used by
.B weave
output.
Modified: trunk/Build/source/texk/web2c/weav-twill.ch
===================================================================
--- trunk/Build/source/texk/web2c/weav-twill.ch 2022-01-09 00:49:24 UTC (rev 61545)
+++ trunk/Build/source/texk/web2c/weav-twill.ch 2022-01-09 10:40:50 UTC (rev 61546)
@@ -427,15 +427,15 @@
@.\\input webmac@>
@.webmac@>
@y
-`\.{\\input twimac}'.
- at .\\input twimac@>
- at .twimac@>
+`\.{\\input twimac-web}'.
+ at .\\input twimac-web@>
+ at .twimac-web@>
@z
@x 2204c2367
out_ptr:=1; out_line:=1; out_buf[1]:="c"; write(tex_file,'\input webma');
@y
-out_ptr:=1; out_line:=1; out_buf[1]:="c"; write(tex_file,'\input twima');
+out_ptr:=1; out_line:=1; out_buf[1]:="b"; write(tex_file,'\input twimac-we');
@z
Section 125.
@@ -497,6 +497,14 @@
end;
@z
+Section 146.
+
+ at x 2888c...
+@ Token lists in |@!tok_mem| are composed of the following kinds of
+ at y
+@ Token lists in |tok_mem| are composed of the following kinds of
+ at z
+
Section 183.
@x 3522a3702
@@ -694,7 +702,7 @@
@<Functions |scan_const| and |scan_exp|@>=
function scan_const:integer;
label done;
-var radix,accum,p:integer;
+var radix,@!accum,p:integer;
begin if next_control=string then
begin accum:=buffer[id_first+1]; next_control:=get_next; goto done;
end
@@ -732,7 +740,7 @@
@<Functions |scan_const| and |scan_exp|@>=
function scan_exp:integer;
label done;
-var accum,s:integer;
+var @!accum,s:integer;
begin if sign(next_control) then accum:=0
else accum:=scan_const;
loop begin if not sign(next_control) then goto done;
More information about the tex-live-commits
mailing list.