summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/cweb.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-03-04 16:00:29 +0000
committerKarl Berry <karl@freefriends.org>2022-03-04 16:00:29 +0000
commit5027858830867ff20c7eca53eed6f8b798c5ad9c (patch)
tree842f07fed6d88920a1bcdc035157bb20e17e7904 /Master/texmf-dist/doc/man/man1/cweb.1
parentf23f3a09677e44ad094dcf2aa3ac0c3dc3893238 (diff)
2022 doc (+sync) update
git-svn-id: svn://tug.org/texlive/trunk@62387 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/cweb.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/cweb.139
1 files changed, 31 insertions, 8 deletions
diff --git a/Master/texmf-dist/doc/man/man1/cweb.1 b/Master/texmf-dist/doc/man/man1/cweb.1
index cf7273f0219..84e17026ac0 100644
--- a/Master/texmf-dist/doc/man/man1/cweb.1
+++ b/Master/texmf-dist/doc/man/man1/cweb.1
@@ -1,6 +1,20 @@
-.\" Automatically generated by Pandoc 2.11.4
+.\" Automatically generated by Pandoc
.\"
-.TH "CWEB" "1" "September 23, 2020" "Web2c 2021" "General Commands Manual"
+.\" Define V font for inline verbatim, using C font in formats
+.\" that render this, and otherwise B font.
+.ie "\f[CB]x\f[]"x" \{\
+. ftr V B
+. ftr VI BI
+. ftr VB B
+. ftr VBI BI
+.\}
+.el \{\
+. ftr V CR
+. ftr VI CI
+. ftr VB CB
+. ftr VBI CBI
+.\}
+.TH "CWEB" "1" "July 27, 2021" "Web2c 2022" "General Commands Manual"
.hy
.SH NAME
.PP
@@ -55,7 +69,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 +109,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]: check temporary output for 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 +136,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 +186,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.