summaryrefslogtreecommitdiff
path: root/Build/source/texk/web2c/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-01-06 23:19:16 +0000
committerKarl Berry <karl@freefriends.org>2019-01-06 23:19:16 +0000
commit976f2b9b61a086f8594f6bfe6dbea42faa56edb2 (patch)
tree9e620153df80a27b0304ae9827fa0f69a02191e0 /Build/source/texk/web2c/man
parentb109e3c47399f4fdfc7805b8f9168c7452f78e96 (diff)
cwebbin for cweb, from Andreas Scherer https://github.com/ascherer/cwebbin)
git-svn-id: svn://tug.org/texlive/trunk@49626 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c/man')
-rw-r--r--Build/source/texk/web2c/man/ChangeLog4
-rw-r--r--Build/source/texk/web2c/man/cweb.man44
2 files changed, 30 insertions, 18 deletions
diff --git a/Build/source/texk/web2c/man/ChangeLog b/Build/source/texk/web2c/man/ChangeLog
index 38f3f7588ed..bfac001673a 100644
--- a/Build/source/texk/web2c/man/ChangeLog
+++ b/Build/source/texk/web2c/man/ChangeLog
@@ -1,3 +1,7 @@
+2019-01-06 Andreas Scherer <https://ascherer.github.io>
+
+ * cweb.man: update for CWEBbin options, etc.
+
2018-12-21 Karl Berry <karl@freefriends.org>
* mpost.man: mention rmpost, (r)pmpost, and (r)upmpost.
diff --git a/Build/source/texk/web2c/man/cweb.man b/Build/source/texk/web2c/man/cweb.man
index 82a134a8dd2..f25d97d82ae 100644
--- a/Build/source/texk/web2c/man/cweb.man
+++ b/Build/source/texk/web2c/man/cweb.man
@@ -1,24 +1,22 @@
-.TH CWEB 1 "28 October 2018" "Web2C @VERSION@"
+.TH CWEB 1 "6 January 2018" "Web2C @VERSION@"
.\"=====================================================================
.SH NAME
ctangle, cweave \- translate CWEB to C and/or TeX
.\"=====================================================================
.SH SYNOPSIS
-.na
.B ctangle
-.RB [ \-bhp ]
-.RB [ +s ]
+.RB [ +bhps ]
.IR webfile [ \fB.w\fP ]
.RI [{ changefile [ \fB.ch\fP ]| \fB\-\fP }
.RI [ outfile [ \fB.c\fP ]]]
.br
.B cweave
-.RB [ \-befhpx ]
-.RB [ +s ]
+.RB [ \-fiox ]
+.RB [ \-lX | +lX ]
+.RB [ +behps ]
.IR webfile [ \fB.w\fP ]
.RI [{ changefile [ \fB.ch\fP ]| \fB\-\fP }
.RI [ outfile [ \fB.tex\fP ]]]
-.ad
.\"=====================================================================
.SH DESCRIPTION
The
@@ -72,27 +70,26 @@ default).
In fact, the options are processed from left to right,
so a sequence like -f\ +f corresponds to +f (which is the default).
.PP
+Both programs operate silently by default (as of 2019).
+.PP
The
-.B \-b
-option suppresses the banner line that normally appears on your terminal
+.B +b
+option prints the banner line on your terminal
when ctangle or cweave begins.
The
-.B \-h
-option suppresses the happy message that normally appears if the processing
+.B +h
+option prints the happy message if the processing
was successful.
The
-.B \-p
-option suppresses progress reports (starred module numbers) as the processing
+.B +p
+option prints progress reports (starred module numbers) as the processing
takes place.
-If you say
-.BR \-bhp ,
-you get nothing but error messages.
.PP
The
.B +s
option prints statistics about memory usage at the end of a run.
.PP
-There are three other options applicable to
+There are six other options applicable to
.B cweave
only:
.B \-f
@@ -106,6 +103,14 @@ Such brackets are normally inserted so that special hooks
can be used by
.I cweb-latex
and similar programs.
+.B \-i
+suppresses the indentation of parameter declarations.
+.B \-lX
+(or
+.B +lX
+) uses macros for language X\ from Xcwebmac.tex.
+.B \-o
+suppresses the visual separation of declarations and statements.
.B \-x
means omit the index and table of contents.
.\"=====================================================================
@@ -144,8 +149,11 @@ and the source code listings).
.\"=====================================================================
.SH AUTHORS
Don Knuth wrote WEB for TeX and Pascal.
+.br
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.
Many other helpers are acknowledged in the CWEB manual.
-
+.br
+Andreas Scherer developed the extended CWEBbin version. As of 2019, the
+CWEB system in TeX Live is CWEBbin; see https://github.com/ascherer/cwebbin.