texlive[49898] Build/source/texk/web2c/man: Recompile CWEB manpages

commits+ascherer at tug.org commits+ascherer at tug.org
Fri Feb 1 19:23:35 CET 2019


Revision: 49898
          http://tug.org/svn/texlive?view=revision&revision=49898
Author:   ascherer
Date:     2019-02-01 19:23:34 +0100 (Fri, 01 Feb 2019)
Log Message:
-----------
Recompile CWEB manpages with Pandoc 2.6.

>From the Pandoc release page https://github.com/jgm/pandoc/releases/tag/2.6 :
Man/Ms writers: Don't escape - as \-. The \- gets rendered in HTML and PDF
as a unicode minus sign.

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

Modified: trunk/Build/source/texk/web2c/man/ChangeLog
===================================================================
--- trunk/Build/source/texk/web2c/man/ChangeLog	2019-02-01 10:03:15 UTC (rev 49897)
+++ trunk/Build/source/texk/web2c/man/ChangeLog	2019-02-01 18:23:34 UTC (rev 49898)
@@ -1,3 +1,10 @@
+2019-02-01  Andreas Scherer  <https://ascherer.github.io>
+
+	* ctwill.man,
+	* cweb.man: Recompile manpages with Pandoc 2.6.  This un-escapes
+	'-', because it was rendered as "unicode minus"; see release page
+	https://github.com/jgm/pandoc/releases/tag/2.6
+
 2019-01-28  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	2019-02-01 10:03:15 UTC (rev 49897)
+++ trunk/Build/source/texk/web2c/man/ctwill.man	2019-02-01 18:23:34 UTC (rev 49898)
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pandoc 2.5
+.\" Automatically generated by Pandoc 2.6
 .\"
 .TH "CTWILL" "1" "January 27, 2019" "Web2c @VERSION@" "General Commands Manual"
 .hy
@@ -8,11 +8,11 @@
 .PD 0
 .P
 .PD
-with mini\-indexes per spread or per section
+with mini-indexes per spread or per section
 .SH SYNOPSIS
 .PP
 \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]]]
+[{\f[I]changefile\f[R][.ch]|-} [\f[I]outfile\f[R][.tex]]]
 .PD 0
 .P
 .PD
@@ -28,12 +28,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
@@ -49,7 +49,7 @@
 file, which is ordinarily the same as the name of the input file (but on
 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.
+change file to apply, you can use `\f[B]-\f[R]' as the second argument.
 .PP
 \f[B]ctwill\f[R] is exactly like \f[B]cweave\f[R] except that it
 produces much better documentation, for which you must work harder.
@@ -58,7 +58,7 @@
 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
 foo\f[R] will produce alphabetized output.
@@ -68,8 +68,8 @@
 The individual programs should define their names with a line of the
 form \f[B]\[rs]def\[rs]title{NAME}\f[R].
 .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.
@@ -84,7 +84,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
@@ -93,27 +93,27 @@
 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 (\f[I]without\f[R] mini\-indexes) in which
+specially formatted document (\f[I]without\f[R] mini-indexes) in which
 you can check that your specifications are correct.
 .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.
 .SH DIFFERENCES TO ORIGINAL CTWILL
 .PP
 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 (3.64c).
 .IP \[bu] 2
-In TeX\ Live the utility programs are prefixed with \f[B]ctwill\-\f[R]
+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
+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.
 .IP \[bu] 2
 Option \f[B]+lX\f[R] is accompanied by example wrapper files for
@@ -121,22 +121,22 @@
 captions for German (\f[B]+ld\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.
+\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.
 .IP \[bu] 2
 If properly configured, the main program \f[B]ctwill\f[R] is localized
 with the \[lq]GNU gettext utilities\[rq].
 .SH OPTIONS
 .PP
-Options on the command line may be either turned off with `\f[B]\-\f[R]'
+Options on the command line may be either turned off with `\f[B]-\f[R]'
 (if they are on by default) or turned on with `\f[B]+\f[R]' (if they are
 off by default).
 In fact, the options are processed from left to right, so a sequence
-like \f[B]\-\-verbose \-h\f[R] will only show the \f[B]banner line\f[R]
+like \f[B]--verbose -h\f[R] will only show the \f[B]banner line\f[R]
 (\f[B]+b\f[R]) and the \f[B]progress report\f[R] (\f[B]+p\f[R]), but
-leave out the \f[B]happy message\f[R] (\f[B]\-h\f[R]).
+leave out the \f[B]happy message\f[R] (\f[B]-h\f[R]).
 .IP \[bu] 2
 \f[B]+b\f[R]: print banner line on terminal
 .IP \[bu] 2
@@ -144,34 +144,34 @@
 .IP \[bu] 2
 \f[B]+p\f[R]: print progress report messages
 .IP \[bu] 2
-\f[B]+q\f[R]/\f[B]\-q\f[R]: shortcut for \f[B]\-bhp\f[R]; also
-\f[B]\-\-quiet\f[R] (default)
+\f[B]+q\f[R]/\f[B]-q\f[R]: shortcut for \f[B]-bhp\f[R]; also
+\f[B]--quiet\f[R] (default)
 .IP \[bu] 2
-\f[B]+v\f[R]/\f[B]\-v\f[R]: shortcut for \f[B]+bhp\f[R]; also
-\f[B]\-\-verbose\f[R]
+\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]\-e\f[R]: do not enclose C/C++\ material in \f[B]\f[R]
+\f[B]-e\f[R]: do not enclose C/C++\ material in \f[B]\f[R]
 .IP \[bu] 2
-\f[B]\-f\f[R]: do not force a newline after every C/C++\ statement in
+\f[B]-f\f[R]: do not force a newline after every C/C++\ statement in
 output
 .IP \[bu] 2
-\f[B]\-i\f[R]: suppress indentation of parameter declarations
+\f[B]-i\f[R]: suppress indentation of parameter declarations
 .IP \[bu] 2
-\f[B]\-o\f[R]: suppress separation of declarations and statements
+\f[B]-o\f[R]: suppress separation of declarations and statements
 .IP \[bu] 2
-\f[B]\-x\f[R]: omit indices, section names, table of contents
+\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
 \f[B]ctwimac.tex\f[R]
 .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[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]ctwimac\f[R]|\f[B]ctproofmac\f[R]}\f[B].tex\f[R]
 .IP \[bu] 2
 \f[B]+s\f[R]: print usage statistics
 .IP \[bu] 2
-\f[B]\-\-help\f[R]: display help message and exit
+\f[B]--help\f[R]: display help message and exit
 .IP \[bu] 2
-\f[B]\-\-version\f[R]: output version information and exit
+\f[B]--version\f[R]: output version information and exit
 .SH ENVIRONMENT
 .PP
 The environment variable CWEBINPUTS is used to search for the input

Modified: trunk/Build/source/texk/web2c/man/cweb.man
===================================================================
--- trunk/Build/source/texk/web2c/man/cweb.man	2019-02-01 10:03:15 UTC (rev 49897)
+++ trunk/Build/source/texk/web2c/man/cweb.man	2019-02-01 18:23:34 UTC (rev 49898)
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pandoc 2.5
+.\" Automatically generated by Pandoc 2.6
 .\"
 .TH "CWEB" "1" "January 27, 2019" "Web2c @VERSION@" "General Commands Manual"
 .hy
@@ -8,12 +8,12 @@
 .SH SYNOPSIS
 .PP
 \f[B]ctangle\f[R] [\f[I]options\f[R]] \f[I]webfile\f[R][.w]
-[{\f[I]changefile\f[R][.ch]|\-} [\f[I]outfile\f[R][.c]]]
+[{\f[I]changefile\f[R][.ch]|-} [\f[I]outfile\f[R][.c]]]
 .PD 0
 .P
 .PD
 \f[B]cweave\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]]]
+[{\f[I]changefile\f[R][.ch]|-} [\f[I]outfile\f[R][.tex]]]
 .SH DESCRIPTION
 .PP
 The \f[B]ctangle\f[R] program converts a CWEB source document into a
@@ -25,12 +25,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
@@ -46,16 +46,16 @@
 file, which is ordinarily the same as the name of the input file (but on
 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.
+change file to apply, you can use `\f[B]-\f[R]' as the second argument.
 .SH DIFFERENCES TO ORIGINAL CWEB
 .PP
-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:
 .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
+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.
 .IP \[bu] 2
 Option \f[B]+lX\f[R] is accompanied by several wrapper files for
@@ -63,22 +63,22 @@
 (\f[B]+ld\f[R]), French (\f[B]+lf\f[R]), and Italian (\f[B]+li\f[R]).
 .IP \[bu] 2
 CWEB in TeX\ Live operates silently by default (as of 2019); use the
-\f[B]\-\-verbose\f[R] option to get the original behavior.
+\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.
 .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].
 .SH OPTIONS
 .PP
-Options on the command line may be either turned off with `\f[B]\-\f[R]'
+Options on the command line may be either turned off with `\f[B]-\f[R]'
 (if they are on by default) or turned on with `\f[B]+\f[R]' (if they are
 off by default).
 In fact, the options are processed from left to right, so a sequence
-like \f[B]\-\-verbose \-h\f[R] will only show the \f[B]banner line\f[R]
+like \f[B]--verbose -h\f[R] will only show the \f[B]banner line\f[R]
 (\f[B]+b\f[R]) and the \f[B]progress report\f[R] (\f[B]+p\f[R]), but
-leave out the \f[B]happy message\f[R] (\f[B]\-h\f[R]).
+leave out the \f[B]happy message\f[R] (\f[B]-h\f[R]).
 .PP
 The first batch of options are common to both \f[B]ctangle\f[R] and
 \f[B]cweave\f[R]:
@@ -89,33 +89,32 @@
 .IP \[bu] 2
 \f[B]+p\f[R]: print progress report messages
 .IP \[bu] 2
-\f[B]+q\f[R]/\f[B]\-q\f[R]: shortcut for \f[B]\-bhp\f[R]; also
-\f[B]\-\-quiet\f[R] (default)
+\f[B]+q\f[R]/\f[B]-q\f[R]: shortcut for \f[B]-bhp\f[R]; also
+\f[B]--quiet\f[R] (default)
 .IP \[bu] 2
-\f[B]+v\f[R]/\f[B]\-v\f[R]: shortcut for \f[B]+bhp\f[R]; also
-\f[B]\-\-verbose\f[R]
+\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
 .IP \[bu] 2
-\f[B]\-\-help\f[R]: display help message and exit
+\f[B]--help\f[R]: display help message and exit
 .IP \[bu] 2
-\f[B]\-\-version\f[R]: output version information and exit
+\f[B]--version\f[R]: output version information and exit
 .PP
 There are six 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]
+\f[B]-e\f[R]: do not enclose C/C++\ material in \f[B]\[rs]PB{\&...}\f[R]
 .IP \[bu] 2
-\f[B]\-f\f[R]: do not force a newline after every C/C++\ statement in
+\f[B]-f\f[R]: do not force a newline after every C/C++\ statement in
 output
 .IP \[bu] 2
-\f[B]\-i\f[R]: suppress indentation of parameter declarations
+\f[B]-i\f[R]: suppress indentation of parameter declarations
 .IP \[bu] 2
-\f[B]\-o\f[R]: suppress separation of declarations and statements
+\f[B]-o\f[R]: suppress separation of declarations and statements
 .IP \[bu] 2
-\f[B]\-x\f[R]: omit indices, section names, table of contents
+\f[B]-x\f[R]: omit indices, section names, table of contents
 .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[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]
 .SH ENVIRONMENT
 .PP



More information about the tex-live-commits mailing list