From 1e9e7843c8f3dd00f3beff690e97e329c552dddb Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 27 Feb 2021 17:39:48 +0000 Subject: doc updates for 2021 git-svn-id: svn://tug.org/texlive/trunk@57972 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/ctwill.1 | 30 +++++++++++++++++++----------- 1 file changed, 19 insertions(+), 11 deletions(-) (limited to 'Master/texmf-dist/doc/man/man1/ctwill.1') 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. -- cgit v1.2.3