summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/ctwill.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/ctwill.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/ctwill.130
1 files changed, 19 insertions, 11 deletions
diff --git a/Master/texmf-dist/doc/man/man1/ctwill.1 b/Master/texmf-dist/doc/man/man1/ctwill.1
index 48bbed1d2f3..cfac2030f35 100644
--- a/Master/texmf-dist/doc/man/man1/ctwill.1
+++ b/Master/texmf-dist/doc/man/man1/ctwill.1
@@ -1,14 +1,10 @@
-.\" Automatically generated by Pandoc 2.9.1.1
+.\" Automatically generated by Pandoc 2.11.4
.\"
-.TH "CTWILL" "1" "December 7, 2019" "Web2c 2020" "General Commands Manual"
+.TH "CTWILL" "1" "February 6, 2021" "Web2c 2021" "General Commands Manual"
.hy
.SH NAME
.PP
-ctwill, ctwill-refsort, ctwill-twinx \[en] translate CWEB to TeX
-.PD 0
-.P
-.PD
-with mini-indexes per spread or per section
+ctwill, ctwill-refsort, ctwill-twinx - translate CWEB to TeX with mini-indexes
.SH SYNOPSIS
.PP
\f[B]ctwill\f[R] [\f[I]options\f[R]] \f[I]webfile\f[R][.w]
@@ -110,24 +106,28 @@ 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 (3.64c).
+This version is based on the most recent version of CWEB (4.2).
.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], and
-\f[B]+lX\f[R] are new in CWEBbin and TeX\ Live.
+\f[B]--version\f[R], and flags \f[B]-i\f[R], \f[B]-o\f[R], \f[B]-t\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
\f[B]ctwimac.tex\f[R] and \f[B]ctproofmac.tex\f[R] with translated
captions for German (\f[B]+ld\f[R]).
.IP \[bu] 2
+Option \f[B]+lX\f[R] is also accompanied by an extended
+\f[B]pdfctwimac.tex\f[R] for production of PDF output with active
+hyperlinks (\f[B]+lpdf\f[R]).
+.IP \[bu] 2
\f[B]ctwill\f[R] in TeX\ Live operates silently by default; use the
\f[B]--verbose\f[R] option to get the original behavior.
.IP \[bu] 2
File lookup with the environment variable CWEBINPUTS is extended to
-permit several, colon-separated, paths.
+permit several, colon-separated, paths; see ENVIRONMENT below.
.IP \[bu] 2
If properly configured, the main program \f[B]ctwill\f[R] is localized
with the \[lq]GNU gettext utilities\[rq].
@@ -162,6 +162,8 @@ 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
@@ -180,6 +182,9 @@ output
The environment variable CWEBINPUTS is used to search for the input
files, or the system default if CWEBINPUTS is not set.
See tex(1) for the details of the searching.
+To avoid conflicts with other programs that also use the CWEBINPUTS
+environment, you can be more specific and use CWEBINPUTS_cweb for
+special requirements in CWEB.
.PP
If prepared for NLS support, \f[B]ctwill\f[R] like \f[B]ctangle\f[R] and
\f[B]cweave\f[R] uses the environment variable TEXMFLOCALEDIR to
@@ -204,6 +209,9 @@ In both cases you can request some prefix \f[I]X\f[R] with the
\f[B]+lX\f[R] option, e.g., \f[B]+ld\f[R] will \f[B]\[rs]input
dctwimac.tex\f[R] and \f[B]+Pld\f[R] will \f[B]\[rs]input
dctproofmac.tex\f[R].
+A special application is the use of option \f[B]+lpdf\f[R] that will
+\f[B]\[rs]input pdfctwimac.tex\f[R] for production of PDF output with
+active hyperlinks.
.IP \[bu] 2
\f[I]webfile\f[R]\f[B].bux\f[R]: Reference definitions to resolve from
other modules.