texlive[70042] Build/source/texk/web2c/man: [C/WEB] Unmask hyphen in
commits+ascherer at tug.org
commits+ascherer at tug.org
Wed Feb 21 15:16:57 CET 2024
Revision: 70042
https://tug.org/svn/texlive?view=revision&revision=70042
Author: ascherer
Date: 2024-02-21 15:16:57 +0100 (Wed, 21 Feb 2024)
Log Message:
-----------
[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).
Modified Paths:
--------------
trunk/Build/source/texk/web2c/man/ChangeLog
trunk/Build/source/texk/web2c/man/ctwill.man
trunk/Build/source/texk/web2c/man/cweb.man
trunk/Build/source/texk/web2c/man/twill.man
Modified: trunk/Build/source/texk/web2c/man/ChangeLog
===================================================================
--- trunk/Build/source/texk/web2c/man/ChangeLog 2024-02-21 09:36:51 UTC (rev 70041)
+++ trunk/Build/source/texk/web2c/man/ChangeLog 2024-02-21 14:16:57 UTC (rev 70042)
@@ -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,
Modified: trunk/Build/source/texk/web2c/man/ctwill.man
===================================================================
--- trunk/Build/source/texk/web2c/man/ctwill.man 2024-02-21 09:36:51 UTC (rev 70041)
+++ trunk/Build/source/texk/web2c/man/ctwill.man 2024-02-21 14:16:57 UTC (rev 70042)
@@ -2,8 +2,8 @@
.\"
.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]]]
@@ -10,16 +10,16 @@
.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
@@ -26,12 +26,12 @@
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 @@
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 @@
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,18 +95,18 @@
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).
@@ -113,13 +113,13 @@
.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 @@
\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].
Modified: trunk/Build/source/texk/web2c/man/cweb.man
===================================================================
--- trunk/Build/source/texk/web2c/man/cweb.man 2024-02-21 09:36:51 UTC (rev 70041)
+++ trunk/Build/source/texk/web2c/man/cweb.man 2024-02-21 14:16:57 UTC (rev 70042)
@@ -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 @@
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 @@
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 @@
\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 @@
.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
Modified: trunk/Build/source/texk/web2c/man/twill.man
===================================================================
--- trunk/Build/source/texk/web2c/man/twill.man 2024-02-21 09:36:51 UTC (rev 70041)
+++ trunk/Build/source/texk/web2c/man/twill.man 2024-02-21 14:16:57 UTC (rev 70042)
@@ -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 @@
[\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 @@
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 @@
.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 @@
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 @@
.\"=====================================================================
.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.
More information about the tex-live-commits
mailing list.