diff options
author | Andreas Scherer <andreas_tex@freenet.de> | 2024-02-21 14:16:57 +0000 |
---|---|---|
committer | Andreas Scherer <andreas_tex@freenet.de> | 2024-02-21 14:16:57 +0000 |
commit | 8bc66a3a8054b256bd619d7dd8e19fa4cc5ca8be (patch) | |
tree | 90462af7d74a164c9865773a21e6e12c2d30db36 | |
parent | a10aefb86bd3e1c6165718597111cf1aa40450ca (diff) |
[C/WEB] Unmask hyphen in manpages.
Pandoc really gets overboard with masking every single hyphen; the
resulting *.man1.pdf files look plain ugly.
I revert all unnecessary maskings (upstream); 'minus' is used only where
required or conventional (e.g., for '\-o'ptions).
git-svn-id: svn://tug.org/texlive/trunk@70042 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r-- | Build/source/texk/web2c/man/ChangeLog | 6 | ||||
-rw-r--r-- | Build/source/texk/web2c/man/ctwill.man | 46 | ||||
-rw-r--r-- | Build/source/texk/web2c/man/cweb.man | 12 | ||||
-rw-r--r-- | Build/source/texk/web2c/man/twill.man | 14 |
4 files changed, 42 insertions, 36 deletions
diff --git a/Build/source/texk/web2c/man/ChangeLog b/Build/source/texk/web2c/man/ChangeLog index 282e21ef5e3..267a2818644 100644 --- a/Build/source/texk/web2c/man/ChangeLog +++ b/Build/source/texk/web2c/man/ChangeLog @@ -1,3 +1,9 @@ +2024-02-21 Andreas Scherer <https://ascherer.github.io> + + * ctwill.man, + * cweb.man, + * twill.man: Unmask hyphen in manpages. + 2024-02-16 Andreas Scherer <https://ascherer.github.io> * ctwill.man, diff --git a/Build/source/texk/web2c/man/ctwill.man b/Build/source/texk/web2c/man/ctwill.man index 76c14c1218b..f1826cf561b 100644 --- a/Build/source/texk/web2c/man/ctwill.man +++ b/Build/source/texk/web2c/man/ctwill.man @@ -2,36 +2,36 @@ .\" .TH "CTWILL" "1" "February 16, 2024" "Web2c @VERSION@" "General Commands Manual" .SH NAME -ctwill, ctwill\-proofsort, ctwill\-refsort, ctwill\-twinx \- translate CWEB to TeX with -mini\-indexes +ctwill, ctwill-proofsort, ctwill-refsort, ctwill-twinx \- translate CWEB to TeX with +mini-indexes .SH SYNOPSIS \f[B]ctwill\f[R] [\f[I]options\f[R]] \f[I]webfile\f[R][.w] [{\f[I]changefile\f[R][.ch]|\-} [\f[I]outfile\f[R][.tex]]] .PD 0 .P .PD -( \f[B]ctwill\-proofsort\f[R] < \f[I]texfile\f[R].tex ) 1<> +( \f[B]ctwill-proofsort\f[R] < \f[I]texfile\f[R].tex ) 1<> \f[I]texfile\f[R].tex .PD 0 .P .PD -\f[B]ctwill\-refsort\f[R] < \f[I]indexfile\f[R].ref > \f[I]indexfile\f[R].sref +\f[B]ctwill-refsort\f[R] < \f[I]indexfile\f[R].ref > \f[I]indexfile\f[R].sref .PD 0 .P .PD -\f[B]ctwill\-twinx\f[R] \f[I]outfile\f[R].tex [\f[I]outfile\f[R].tex \&...] +\f[B]ctwill-twinx\f[R] \f[I]outfile\f[R].tex [\f[I]outfile\f[R].tex \&...] > index.tex .SH DESCRIPTION The \f[B]ctwill\f[R] program converts a CWEB source document into a TeX\ file that may be formatted and printed in the usual way. It takes appropriate care of typographic details like page layout and the use of indentation, \f[I]italics\f[R], \f[B]boldface\f[R], etc., and -it supplies extensive cross\-index information that it gathers +it supplies extensive cross-index information that it gathers automatically. .PP CWEB allows you to prepare a single document containing all the information that is needed both to produce a compilable C/C++\ program -and to produce a well\-formatted document describing the program in as +and to produce a well-formatted document describing the program in as much detail as the writer may desire. The user of CWEB ought to be familiar with TeX as well as C/C++. .SH USAGE @@ -55,23 +55,23 @@ to get decent answers. Moreover, you must run the output twice through TeX. .PP After \f[B]tex foo\f[R] you will have output that looks like final pages -except that the entries of mini\-indexes won\[cq]t be alphabetized. +except that the entries of mini-indexes won\[cq]t be alphabetized. The first run produces a weird file called \f[B]foo.ref\f[R]. -Say \f[B]ctwill\-refsort < foo.ref > foo.sref\f[R] and then another \f[B]tex +Say \f[B]ctwill-refsort < foo.ref > foo.sref\f[R] and then another \f[B]tex foo\f[R] will produce alphabetized output. .PP -The \f[B]ctwill\-twinx\f[R] program compiles a master index for a set of related +The \f[B]ctwill-twinx\f[R] program compiles a master index for a set of related programs that have been processed by \f[B]ctwill\f[R] (\f[I]not\f[R] by \f[B]cweave\f[R], mind you!). The individual programs should define their names with a line of the form \f[B]\[rs]def\[rs]title{NAME}\f[R]. -For your convenience, \f[B]ctwill\-twinx\f[R] grabs the first \[lq]word\[rq] in +For your convenience, \f[B]ctwill-twinx\f[R] grabs the first \[lq]word\[rq] in \f[B]\[rs]title\f[R] and turns it into uppercase form. -You should adapt file \f[B]ctwill\-twinx\-startup.tex\f[R] for the first page of +You should adapt file \f[B]twinx-startup.tex\f[R] for the first page of the master index. .PP -The mini\-indexes list identifiers that are used but not defined on each -two\-page spread. +The mini-indexes list identifiers that are used but not defined on each +two-page spread. At the end of each section, \f[B]ctwill\f[R] gives TeX a list of identifiers used in that section and information about where they are defined. @@ -86,7 +86,7 @@ for a file called \f[B]system.bux\f[R], which will be read if present. And after \f[B]foo.aux\f[R], a third possibility is \f[B]foo.bux\f[R]. The general convention is to put definitions of system procedures such as \f[I]printf\f[R] into \f[B]system.bux\f[R], and to put definitions -found in specifically foo\-ish header files into \f[B]foo.bux\f[R]. +found in specifically foo-ish header files into \f[B]foo.bux\f[R]. Like the \f[B].aux\f[R] files, \f[B].bux\f[R] files should contain only \f[B]\[at]$\f[R] specifications. .PP @@ -95,31 +95,31 @@ components: an identifier (followed by space), a program name (enclosed in braces), a section number (followed by space), and a TeX\ part. .PP A special \f[I]proofmode\f[R] is provided so that you can check -\f[B]ctwill\f[R]\[cq]s conclusions about cross\-references. +\f[B]ctwill\f[R]\[cq]s conclusions about cross-references. Run \f[B]ctwill\f[R] with the flag \f[B]+P\f[R], and TeX will produce a -specially formatted document with mini\-indexes for each section, so +specially formatted document with mini-indexes for each section, so that you can check that your specifications are correct. .PP This \f[I]proofmode\f[R] format is used in conjunction with \f[B]pdfctproofmac.tex\f[R] that creates active hyperlinks in PDF and HINT output. -You can use \f[B]ctwill\-proofsort\f[R] to get the index entries in alphabetical +You can use \f[B]ctwill-proofsort\f[R] to get the index entries in alphabetical order; just invoke .PP -( \f[B]ctwill\-proofsort\f[R] < \f[I]texfile\f[R].tex ) 1<> +( \f[B]ctwill-proofsort\f[R] < \f[I]texfile\f[R].tex ) 1<> \f[I]texfile\f[R].tex .PP after invoking \f[B]ctwill\f[R] (twice), but before invoking TeX (once). .PP More details how to use \f[B]ctwill\f[R] can be found in the first sections of its source code, respectively the change file -\f[B]cweav\-twill.ch\f[R] applicable to the \f[B]cweave.w\f[R] source. +\f[B]cweav-twill.ch\f[R] applicable to the \f[B]cweave.w\f[R] source. A complete example with all bells and whistles is described in -\f[B]Mini\-Indexes for Literate Programs\f[R], pages 225\[en]245 of +\f[B]Mini-Indexes for Literate Programs\f[R], pages 225\[en]245 of Knuth\[cq]s \f[B]Digital Typography\f[R] (\f[I]CSLI\f[R], 1999). .SH DIFFERENCES TO ORIGINAL CTWILL The present incarnation of \f[B]ctwill\f[R] and its utilities tries hard -to be a drop\-in replacement for the original package. +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 (4.11). @@ -143,7 +143,7 @@ active hyperlinks (\f[B]+lpdf\f[R]). \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; see ENVIRONMENT below. +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]. diff --git a/Build/source/texk/web2c/man/cweb.man b/Build/source/texk/web2c/man/cweb.man index 0ae9f37c804..ab0b286e25f 100644 --- a/Build/source/texk/web2c/man/cweb.man +++ b/Build/source/texk/web2c/man/cweb.man @@ -1,6 +1,6 @@ .\" Automatically generated by Pandoc .\" -.TH "CWEB" "1" "August 20, 2022" "Web2c @VERSION@" "General Commands Manual" +.TH "CWEB" "1" "February 21, 2024" "Web2c @VERSION@" "General Commands Manual" .SH NAME ctangle, cweave \- translate CWEB to C/C++ and/or TeX .SH SYNOPSIS @@ -21,12 +21,12 @@ The \f[B]cweave\f[R] program converts the same CWEB file into a TeX\ file that may be formatted and printed in the usual way. It takes appropriate care of typographic details like page layout and the use of indentation, \f[I]italics\f[R], \f[B]boldface\f[R], etc., and -it supplies extensive cross\-index information that it gathers +it supplies extensive cross-index information that it gathers automatically. .PP CWEB allows you to prepare a single document containing all the information that is needed both to produce a compilable C/C++\ program -and to produce a well\-formatted document describing the program in as +and to produce a well-formatted document describing the program in as much detail as the writer may desire. The user of CWEB ought to be familiar with TeX as well as C/C++. .SH USAGE @@ -43,7 +43,7 @@ the current directory) with the extension \f[B].tex\f[R]. If you just want to change the output file name, but don\[cq]t have a change file to apply, you can use `\f[B]\-\f[R]' as the second argument. .SH DIFFERENCES TO ORIGINAL CWEB -CWEBbin tries hard to be a drop\-in replacement for CWEB, so in general +CWEBbin tries hard to be a drop-in replacement for CWEB, so in general you should not notice any differences in invoking the programs nor in the resulting output. There are, however, a few differences worth noting: @@ -61,7 +61,7 @@ CWEB in TeX\ Live operates silently by default (as of 2019); 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; see ENVIRONMENT below. +permit several, colon-separated, paths; see ENVIRONMENT below. .IP \[bu] 2 If properly configured, the main programs \f[B]ctangle\f[R] and \f[B]cweave\f[R] are localized with the \[lq]GNU gettext utilities\[rq]. @@ -101,7 +101,7 @@ 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 .IP \[bu] 2 -\f[B]+u\f[R]: transliterate UTF\-8 charcters in C code +\f[B]+u\f[R]: transliterate UTF-8 characters in C code .PP There are seven other options applicable to \f[B]cweave\f[R] only: .IP \[bu] 2 diff --git a/Build/source/texk/web2c/man/twill.man b/Build/source/texk/web2c/man/twill.man index 99837313726..663fd5267a2 100644 --- a/Build/source/texk/web2c/man/twill.man +++ b/Build/source/texk/web2c/man/twill.man @@ -16,7 +16,7 @@ .if t .ds WB W\s-2EB\s0 .\"===================================================================== .SH NAME -twill, twill\-refsort \- translate \*(WB to \*(TX with mini\-indexes +twill, twill-refsort \- translate \*(WB to \*(TX with mini-indexes .SH SYNOPSIS .PP \f[B]twill\f[R] [\f[B]\-x\f[R]] @@ -25,7 +25,7 @@ twill, twill\-refsort \- translate \*(WB to \*(TX with mini\-indexes [\f[I]outfile\f[R][\f[B].tex\f[R]]]] .PD 0 .PP -\f[B]twill\-refsort\f[R] < +\f[B]twill-refsort\f[R] < \f[I]reffile\f[B].ref\f[R] > \f[I]sreffile\f[B].sref\f[R] .PD @@ -36,7 +36,7 @@ The program is used to create a \*(TX file for viewing a \*(WB program. It takes appropriate care of typographic details like page layout and the use of indentation, italics, boldface, etc., and it supplies -extensive cross\-index information in the form of 'mini\-indexes' for each +extensive cross-index information in the form of 'mini-indexes' for each spread of pages and a 'master index' at the end that it gathers automatically. .PP The command line arguments are the same as for @@ -48,7 +48,7 @@ says to omit the indexes, module name list, and table of contents pages. .I CONTENTS.tex file will still be written when the \*(TX file is processed, however, unless some macros in -.I twimac\-web.tex +.I twimac-web.tex are redefined.) .PP The output \*(TX file name is formed by adding @@ -71,11 +71,11 @@ Moreover, you must run the output twice through \*(TX. After .B tex foo you will have output that looks like final pages -except that the entries of mini\-indexes won\[cq]t be alphabetized. +except that the entries of mini-indexes won\[cq]t be alphabetized. The first run produces a weird file called .B foo.ref. Say -.B twill\-refsort < foo.ref > foo.sref +.B twill-refsort < foo.ref > foo.sref and then another .B tex foo will produce alphabetized output. @@ -88,7 +88,7 @@ for the details of the searching. .\"===================================================================== .SH FILES .TP \w'@@'u+2n -.I $TEXMFMAIN/tex/plain/cweb/cwebbin/twimac\-web.tex +.I $TEXMFMAIN/tex/plain/cweb/cwebbin/twimac-web.tex \*(TX macros used by .B twill output. |