summaryrefslogtreecommitdiff
path: root/Build/source/texk/web2c/man
diff options
context:
space:
mode:
authorAndreas Scherer <andreas_tex@freenet.de>2022-03-02 12:21:24 +0000
committerAndreas Scherer <andreas_tex@freenet.de>2022-03-02 12:21:24 +0000
commit7dadfea71b290543fa374fbd1f5e83ec7101f4d8 (patch)
tree45f91b6e17ef2707e721df15fec8a09c164e1cfa /Build/source/texk/web2c/man
parentbc2dcf1986356357fc6ea795ee5b7147b1286c2d (diff)
[WEB] Optional output file name.
The original WEB programs had fixed arguments on the commandline, i.e., you had to invoke TANGLE with four file name arguments and WEAVE with three (where '/dev/null' was permitted as an empty file). This change makes the WEB programs a little bit like the CWEB programs by allowing an optional third file name argument for the main output file (the name of the .pool file still is created from the .web file). And '-' is interpreted as an empty change file. git-svn-id: svn://tug.org/texlive/trunk@62337 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c/man')
-rw-r--r--Build/source/texk/web2c/man/ChangeLog5
-rw-r--r--Build/source/texk/web2c/man/tangle.man27
-rw-r--r--Build/source/texk/web2c/man/weave.man12
3 files changed, 33 insertions, 11 deletions
diff --git a/Build/source/texk/web2c/man/ChangeLog b/Build/source/texk/web2c/man/ChangeLog
index 708354705c1..e864cde7b68 100644
--- a/Build/source/texk/web2c/man/ChangeLog
+++ b/Build/source/texk/web2c/man/ChangeLog
@@ -1,3 +1,8 @@
+2022-03-02 Andreas Scherer <https://ascherer.github.io>
+
+ * tangle.man,
+ * weave.man: Describe the third file name on the commandline.
+
2022-02-26 Karl Berry <karl@tug.org>
* Makefile.am (web_man_sources): add twill.man.
diff --git a/Build/source/texk/web2c/man/tangle.man b/Build/source/texk/web2c/man/tangle.man
index 3b524db6da7..6f7411d85fd 100644
--- a/Build/source/texk/web2c/man/tangle.man
+++ b/Build/source/texk/web2c/man/tangle.man
@@ -1,4 +1,4 @@
-.TH TANGLE 1 "16 June 2015" "Web2C @VERSION@"
+.TH TANGLE 1 "02 March 2022" "Web2C @VERSION@"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
@@ -21,7 +21,12 @@ tangle \- translate WEB to Pascal
.B tangle
.RI [ options ]
.IR webfile [ \fB.web\fP ]
-.RI [ changefile [ \fB.ch\fP ]]
+[ {
+.IR changefile [ \fB.ch\fP ]
+|\-}
+[
+.IR outfile [ \fB.p\fP ]
+] ]
.\"=====================================================================
.SH DESCRIPTION
This manual page is not meant to be exhaustive. The complete
@@ -47,23 +52,29 @@ familiar with both \*(TX and Pascal. \*(WB also provides a relatively
simple, although adequate, macro facility that permits a Pascal program
to be written in small easily-understood modules.
.PP
-The command line should have either one or two names on it.
+The command line should have one, two or three names on it.
The first is taken as the \*(WB file (and
.B .web
is added if there is no
extension).
-If there is another name, it is a change file (and
+If there is second name, it is a change file (and
.B .ch
is added if there is
no extension). The change file overrides parts of the \*(WB file,
as described in the \*(WB system documentation.
.PP
-The output files are a Pascal file and a string pool file,
-whose names are formed by adding
+If there is a third name, it is the Pascal output file (and
.B .p
-and
+is added if there is no extension). In this case you can specify an empty
+change file with '-' as the second argument.
+Otherwise the name of the Pascal file is formed by adding
+.B .p
+to the root of the \*(WB file name.
+.PP
+An optional second output file is a string pool file,
+whose name is formed by adding
.B .pool
-respectively to the root of the \*(WB file name.
+to the root of the \*(WB file name.
.\"=====================================================================
.SH "OPTIONS"
This version of
diff --git a/Build/source/texk/web2c/man/weave.man b/Build/source/texk/web2c/man/weave.man
index eb6282656d8..295a78581e9 100644
--- a/Build/source/texk/web2c/man/weave.man
+++ b/Build/source/texk/web2c/man/weave.man
@@ -1,4 +1,4 @@
-.TH WEAVE 1 "09 January 2022" "Web2C @VERSION@"
+.TH WEAVE 1 "02 March 2022" "Web2C @VERSION@"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
@@ -21,7 +21,12 @@ weave \- translate WEB to TeX
.B weave
.RB [ \-x ]
.IR webfile [ \fB.web\fP ]
-.RI [ changefile [ \fB.ch\fP ]]
+[ {
+.IR changefile [ \fB.ch\fP ]
+|\-}
+[
+.IR outfile [ \fB.tex\fP ]
+] ]
.\"=====================================================================
.SH DESCRIPTION
This manual page is not meant to be exhaustive. The complete
@@ -49,7 +54,8 @@ are redefined.)
.PP
The output \*(TX file name is formed by adding
.B .tex
-to the root of the \*(WB file name.
+to the root of the \*(WB file name or from the third argument.
+In this case you can specify '-' as an empty change file.
.PP
There are several macros
that probably should be redefined by