pdftex/web2c doc options and other updates

git-svn-id: svn://tug.org/texlive/trunk@51815 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 143 insertions, 147 deletions

diff --git a/Build/source/texk/web2c/ChangeLog b/Build/source/texk/web2c/ChangeLog
index d7413542915..100b340606e 100644
--- a/Build/source/texk/web2c/ChangeLog
+++ b/Build/source/texk/web2c/ChangeLog
@@ -1,3 +1,7 @@
+2019-08-04  Karl Berry  <karl@freefriends.org>
+
+	* doc/web2c.texi (Shell escapes): default value no longer as stated.
+
 2019-07-19  Karl Berry  <karl@tug.org>
 
 	* patgen.ch: mention adding swap/zram to deal with larger tries.
diff --git a/Build/source/texk/web2c/doc/web2c.info b/Build/source/texk/web2c/doc/web2c.info
index 9403f7e81a1..f96cb41aaf8 100644
--- a/Build/source/texk/web2c/doc/web2c.info
+++ b/Build/source/texk/web2c/doc/web2c.info
@@ -1,4 +1,4 @@
-This is web2c.info, produced by makeinfo version 6.5 from web2c.texi.
+This is web2c.info, produced by makeinfo version 6.6 from web2c.texi.
 
 This file documents the installation and use of the programs in Web2c,
 an implementation of Donald Knuth's TeX system.
@@ -58,7 +58,7 @@ Web2c
 
 This document describes how to install and use the programs in the Web2c
 implementation of the TeX system, especially for Unix systems.  It
-corresponds to Web2c version 2019, released in February 2019.
+corresponds to Web2c version 2019, released in August 2019.
 
 * Menu:
 
@@ -82,7 +82,7 @@ File: web2c.info,  Node: Introduction,  Next: Installation,  Prev: Top,  Up: Top
 1 Introduction
 **************
 
-This manual corresponds to version 2019 of Web2c, released in February
+This manual corresponds to version 2019 of Web2c, released in August
 2019.
 
    "Web2c" is the name of a TeX implementation, originally for Unix, but
@@ -1485,9 +1485,10 @@ Otherwise it is not.  In any case, a message is written to the log file.
 
    The 'shell_escape_commands' value is a comma-separated list of words.
 Whitespace is significant, and typically should not be present.  The
-default definition looks like this, but with more commands included:
+default definition in 'texmf.cnf' looks like this, but with more
+commands included:
 
-     shell_escape_commands = bibtex,dvips,epstopdf,...,tex
+     shell_escape_commands = bibtex,kpsewhich,repstopdf,...
 
    pdfTeX and luaTeX support reading (via '\input' and '\openin') and
 writing (via '\openout') from pipes if the first character is '|'.  The
@@ -3571,14 +3572,14 @@ Index
 * \fontdimen:                            tftopl invocation.   (line  99)
 * \immediate\write18:                    Shell escapes.       (line   6)
 * \input filenames:                      \input filenames.    (line   6)
-* \input, and pipes:                     Shell escapes.       (line  63)
+* \input, and pipes:                     Shell escapes.       (line  64)
 * \mag:                                  dvicopy invocation.  (line  20)
 * \mag <1>:                              dvitype invocation.  (line  28)
-* \openin, and pipes:                    Shell escapes.       (line  63)
+* \openin, and pipes:                    Shell escapes.       (line  64)
 * \openout and security:                 tex invocation.      (line  48)
-* \openout, and pipes:                   Shell escapes.       (line  63)
+* \openout, and pipes:                   Shell escapes.       (line  64)
 * \output routine, and \write:           Shell escapes.       (line  28)
-* \pdfshellescape:                       Shell escapes.       (line  63)
+* \pdfshellescape:                       Shell escapes.       (line  64)
 * \string:                               \input filenames.    (line  59)
 * \tracingcharsubdef and MLTeX:          \tracingcharsubdef.  (line   6)
 * \tracinglostchars and MLTeX:           \tracingcharsubdef.  (line  11)
@@ -4088,7 +4089,7 @@ Index
 * pfaedit:                               Font utilities available elsewhere.
                                                               (line  30)
 * PiCTeX, increasing memory for:         Runtime options.     (line  20)
-* pipes, reading and writing:            Shell escapes.       (line  63)
+* pipes, reading and writing:            Shell escapes.       (line  64)
 * pixel height:                          pktype invocation.   (line  62)
 * pixel width:                           pktype invocation.   (line  62)
 * PK bitmaps from PostScript:            Font utilities available elsewhere.
@@ -4341,7 +4342,7 @@ Index
 * vptovf:                                vptovf invocation.   (line   6)
 * weave:                                 weave invocation.    (line   6)
 * WEB:                                   WEB.                 (line   6)
-* web environments, and security:        Shell escapes.       (line  70)
+* web environments, and security:        Shell escapes.       (line  71)
 * WEB pool files, displaying:            pooltype invocation. (line   6)
 * WEB programs, compiling:               tangle invocation.   (line   6)
 * WEB programs, typesetting:             weave invocation.    (line   6)
@@ -4390,74 +4391,74 @@ Index
 
 Tag Table:
 Node: Top2754
-Node: Introduction3752
-Node: Installation6913
-Node: configure options9015
-Node: Compile-time options11037
-Node: Additional targets12139
-Node: Triptrap13416
-Node: Runtime options14943
-Node: Commonalities16701
-Node: Option conventions17302
-Node: Common options18525
-Node: Path searching22905
-Node: Output file location23877
-Node: Three programs25202
-Node: Initial and virgin25956
-Node: Memory dumps26885
-Node: Creating memory dumps27341
-Node: Determining the memory dump to use28552
-Node: Hardware and memory dumps30133
-Node: Editor invocation32583
-Node: \input filenames33450
-Node: TeX36443
-Node: tex invocation37594
-Node: Initial TeX44497
-Node: Formats45861
-Node: Languages and hyphenation48787
-Node: MLTeX49217
-Node: \charsubdef50705
-Node: \tracingcharsubdef53028
-Node: TCX files53603
-Node: patgen invocation59043
-Node: Shell escapes59749
-Node: IPC and TeX63313
-Node: TeX extensions63883
-Node: Metafont65014
-Node: mf invocation66302
-Node: Initial Metafont70139
-Node: Modes71769
-Node: Online Metafont graphics74019
-Node: gftodvi invocation77444
-Node: mft invocation80264
-Node: MetaPost84262
-Node: mpost invocation85024
-Node: Initial MetaPost90200
-Node: dvitomp invocation91122
-Node: BibTeX91787
-Node: bibtex invocation92148
-Node: Basic BibTeX style files94622
-Node: WEB95952
-Node: tangle invocation97161
-Node: weave invocation99284
-Node: pooltype invocation100691
-Node: DVI utilities101821
-Node: dvicopy invocation102753
-Node: dvitype invocation104036
-Node: dvitype output example106365
-Node: Font utilities109416
-Node: Font file formats110596
-Node: gftopk invocation113865
-Node: pktogf invocation115056
-Node: pktype invocation116222
-Node: gftype invocation119045
-Node: tftopl invocation123548
-Node: pltotf invocation128141
-Node: vftovp invocation129192
-Node: vptovf invocation131427
-Node: Font utilities available elsewhere132454
-Node: Legalisms134834
-Node: References136988
-Node: Index141555
+Node: Introduction3750
+Node: Installation6909
+Node: configure options9011
+Node: Compile-time options11033
+Node: Additional targets12135
+Node: Triptrap13412
+Node: Runtime options14939
+Node: Commonalities16697
+Node: Option conventions17298
+Node: Common options18521
+Node: Path searching22901
+Node: Output file location23873
+Node: Three programs25198
+Node: Initial and virgin25952
+Node: Memory dumps26881
+Node: Creating memory dumps27337
+Node: Determining the memory dump to use28548
+Node: Hardware and memory dumps30129
+Node: Editor invocation32579
+Node: \input filenames33446
+Node: TeX36439
+Node: tex invocation37590
+Node: Initial TeX44493
+Node: Formats45857
+Node: Languages and hyphenation48783
+Node: MLTeX49213
+Node: \charsubdef50701
+Node: \tracingcharsubdef53024
+Node: TCX files53599
+Node: patgen invocation59039
+Node: Shell escapes59745
+Node: IPC and TeX63325
+Node: TeX extensions63895
+Node: Metafont65026
+Node: mf invocation66314
+Node: Initial Metafont70151
+Node: Modes71781
+Node: Online Metafont graphics74031
+Node: gftodvi invocation77456
+Node: mft invocation80276
+Node: MetaPost84274
+Node: mpost invocation85036
+Node: Initial MetaPost90212
+Node: dvitomp invocation91134
+Node: BibTeX91799
+Node: bibtex invocation92160
+Node: Basic BibTeX style files94634
+Node: WEB95964
+Node: tangle invocation97173
+Node: weave invocation99296
+Node: pooltype invocation100703
+Node: DVI utilities101833
+Node: dvicopy invocation102765
+Node: dvitype invocation104048
+Node: dvitype output example106377
+Node: Font utilities109428
+Node: Font file formats110608
+Node: gftopk invocation113877
+Node: pktogf invocation115068
+Node: pktype invocation116234
+Node: gftype invocation119057
+Node: tftopl invocation123560
+Node: pltotf invocation128153
+Node: vftovp invocation129204
+Node: vptovf invocation131439
+Node: Font utilities available elsewhere132466
+Node: Legalisms134846
+Node: References137000
+Node: Index141567
 
 End Tag Table
diff --git a/Build/source/texk/web2c/doc/web2c.texi b/Build/source/texk/web2c/doc/web2c.texi
index ee8abb94898..871d811b33a 100644
--- a/Build/source/texk/web2c/doc/web2c.texi
+++ b/Build/source/texk/web2c/doc/web2c.texi
@@ -12,7 +12,7 @@ The latest version is available from ftp://ftp.tug.org/tex/texinfo.tex.}
 @end tex
 
 @set version 2019
-@set month-year February 2019
+@set month-year August 2019
 
 @c Define new indices for commands in auxiliary files, filenames, and options.
 @defcodeindex cm
@@ -1667,11 +1667,11 @@ the log file.
 
 The @code{shell_escape_commands} value is a comma-separated list of
 words.  Whitespace is significant, and typically should not be
-present.  The default definition looks like this, but with more
-commands included:
+present.  The default definition in @file{texmf.cnf} looks like this,
+but with more commands included:
 
 @example
-shell_escape_commands = bibtex,dvips,epstopdf,...,tex
+shell_escape_commands = bibtex,kpsewhich,repstopdf,...
 @end example
 
 @cindex pipes, reading and writing
diff --git a/Build/source/texk/web2c/man/ChangeLog b/Build/source/texk/web2c/man/ChangeLog
index 670ec4ec019..4cde33451fe 100644
--- a/Build/source/texk/web2c/man/ChangeLog
+++ b/Build/source/texk/web2c/man/ChangeLog
@@ -1,3 +1,9 @@
+2019-08-04  Karl Berry  <karl@freefriends.org>
+
+	* pdftex.man (-synctex, -8bit): add per https://bugs.debian.org/772928.
+	(-shell-restricted): also add this.
+	Also don't italicize "PDF" and "DVI", url updates, etc.
+
 2019-06-20  Andreas Scherer  <https://ascherer.github.io>
 
 	* ctwill.man: Regenerate with Pandoc 2.7.3,
diff --git a/Build/source/texk/web2c/man/pdftex.man b/Build/source/texk/web2c/man/pdftex.man
index 4e1ae088a91..421de6ad4fa 100644
--- a/Build/source/texk/web2c/man/pdftex.man
+++ b/Build/source/texk/web2c/man/pdftex.man
@@ -1,4 +1,4 @@
-.TH PDFTEX 1 "4 May 2016" "Web2C @VERSION@"
+.TH PDFTEX 1 "4 August 2019" "Web2C @VERSION@"
 .\"=====================================================================
 .if n .ds MF Metafont
 .if t .ds MF Metafont
@@ -45,16 +45,11 @@ it is usually better to use the
 .I format
 option instead.
 .PP
-pdf\*(TX is a version of \*(TX, with the e-\*(TX extensions, that can create
-.I PDF
-files as well as
-.I DVI
-files.
+pdf\*(TX is a version of \*(TX, with the e-\*(TX extensions, that can
+create PDF files as well as DVI files.
 .PP
-In
-.I DVI
-mode, pdf\*(TX can be used as a complete replacement for the \*(TX
-engine.
+In DVI mode, pdf\*(TX can be used as a complete replacement for the
+\*(TX engine.
 .PP
 The typical use of pdf\*(TX is with a pregenerated formats for which
 PDF output has been enabled.  The
@@ -79,9 +74,7 @@ links to the
 .B pdftex
 executable.
 .PP
-In
-.I PDF
-mode, pdf\*(TX can natively handle the
+In PDF mode, pdf\*(TX can natively handle the
 .IR PDF ,
 .IR JPG ,
 .IR JBIG2 ,
@@ -94,6 +87,10 @@ pdf\*(TX's handling of its command-line arguments is similar to that of
 of the other \*(TX programs in the
 .I web2c
 implementation.
+.PP
+Starting with version 1.40, pdf\*(TX incorporates the e-\*(TX
+extensions, and pdfe\*(TX is just a copy of pdf\*(TX.  See 
+.BR etex (1).
 .\"=====================================================================
 .SH OPTIONS
 This version of pdf\*(TX understands the following command line options.
@@ -208,16 +205,10 @@ or
 .IR tfm .
 .TP
 .BI -output-comment \ string
-In
-.I DVI
-mode, use
+In DVI mode, use
 .I string
-for the
-.I DVI
-file comment instead of the date.  This option is ignored
-in
-.I PDF
-mode.
+for the DVI file comment instead of the date. This option is ignored in
+PDF mode.
 .TP
 .BI -output-directory \ directory
 Write output files in
@@ -258,7 +249,7 @@ in a file with extension
 .TP
 .B -shell-escape
 Enable the
-.BI \ewrite18{ command }
+.RI \ewrite18{ command }
 construct.  The
 .I command
 can be any shell command.  This construct is normally
@@ -266,29 +257,23 @@ disallowed for security reasons.
 .TP
 .B -no-shell-escape
 Disable the
-.BI \ewrite18{ command }
+.RI \ewrite18{ command }
 construct, even if it is enabled in the
 .I texmf.cnf
 file.
 .TP
+.B -shell-restricted
+Enable restricted \ewrite18{}, as explained in the ``Shell escapes''
+section of the Web2c Texinfo manual.
+.TP
 .B -src-specials
-In
-.I DVI
-mode, insert source specials into the
-.I DVI
-file.
-This option is ignored in
-.I PDF
-mode.
+In DVI mode, insert source specials into the DVI file. This option is
+ignored in PDF mode.
 .TP
 .BI -src-specials \ where
-In
-.I DVI
-mode, insert source specials in certain placed of the
-.I DVI
-file.
+In DVI mode, insert source specials in certain places of the DVI file. The
 .I where
-is a comma-separated value list:
+argument is a comma-separated value list:
 .IR cr ,
 .IR display ,
 .IR hbox ,
@@ -297,9 +282,12 @@ is a comma-separated value list:
 .IR parent ,
 or
 .IR vbox .
-This option is ignored in
-.I PDF
-mode.
+This option is ignored in PDF mode.
+.TP
+.BI -synctex \ NUMBER
+generate SyncTeX data for previewers according to bits of NUMBER. See the
+.I synctex
+manual page for details.
 .TP
 .BI -translate-file \ tcxname
 Use the
@@ -316,6 +304,9 @@ line can overrule this setting.
 .TP
 .B -version
 Print version information and exit.
+.TP
+.B -8bit
+make all characters printable by default.
 .\"=====================================================================
 .SH ENVIRONMENT
 See the Kpathsea library documentation (e.g., the `Path specifications'
@@ -325,9 +316,9 @@ The
 utility can be used to query the values of the variables.
 .PP
 One caveat: In most pdf\*(TX formats, you cannot use ~ in a filename you
-give directly to pdf\*(TX, because ~ is an active character, and hence is
-expanded, not taken as part of the filename.  Other programs, such as
-\*(MF, do not have this problem.
+give directly to pdf\*(TX, because ~ is an active character in \*(TX,
+and hence is expanded, not taken as part of the filename. Other
+programs, such as \*(MF, do not have this problem.
 .PP
 .TP
 .B TEXMFOUTPUT
@@ -354,7 +345,7 @@ Search path for
 and
 .I \eopenin
 files.
-This should start with ``.'', so
+This normally starts with ``.'', so
 that user files are found before system files.  An empty path
 component will be replaced with the paths defined in the
 .I texmf.cnf
@@ -409,26 +400,14 @@ Metric files for pdf\*(TX's fonts.
 .TP
 .I *.fmt
 Predigested pdf\*(TX format (.\|fmt) files.
-.br
 .\"=====================================================================
 .SH NOTES
-Starting with version 1.40, pdf\*(TX incorporates the e-\*(TX
-extensions, and pdfe\*(TX is just a copy of pdf\*(TX.  See 
-.BR etex (1).
-This manual page is not meant to be exhaustive.  The complete
-documentation for this version of pdf\*(TX can be found in the 
-.IR "pdf\*(TX manual"
-and the info manual
-.IR "Web2C: A TeX implementation" .
 .\"=====================================================================
 .SH BUGS
 This version of pdf\*(TX fails to trap arithmetic overflow when
 dimensions are added or subtracted.  Cases where this occurs are rare,
 but when it does the generated
-.I DVI
-file will be invalid.  Whether a generated
-.I PDF
-file would be usable is unknown.
+DVI or PDF file will be invalid.  
 .\"=====================================================================
 .SH AVAILABILITY
 pdf\*(TX is available for a large variety of machine architectures
@@ -437,13 +416,20 @@ pdf\*(TX is part of all major \*(TX distributions.
 .br
 The pdf\*(TX home page: http://www.pdftex.org.
 .br
-pdf\*(TX on CTAN: http://www.ctan.org/pkg/pdftex.
+pdf\*(TX on CTAN: https://ctan.org/pkg/pdftex.
 .br
-pdf\*(TX mailing list for all discussion: http://lists.tug.org/pdftex.
+pdf\*(TX mailing list for all discussion: https://lists.tug.org/pdftex.
 .\"=====================================================================
 .SH "SEE ALSO"
-The full pdf\*(TX manual can be accessed from the home page or CTAN page.
-Same for the Web2C, Kpathsea, and other manuals.
+This manual page is not meant to be exhaustive.  The complete
+documentation for this version of pdf\*(TX can be found in the 
+.IR "pdf\*(TX user manual"
+and the Texinfo manuals
+.IR "Kpathsea library" ,
+.IR "Web2C: A TeX implementation" .
+These manuals, and more, can be accessed from the pdfTeX or CTAN web
+pages given above.
+.PP
 Some related programs:
 .BR epstopdf (1),
 .BR etex (1),
@@ -465,6 +451,5 @@ The version now offered with the Unix \*(TX distribution is that
 generated by the \*(WB to C system
 .RB ( web2c ),
 originally written by Tomas Rokicki and Tim Morgan.
-.PP
 The enc\*(TX extensions were written by Petr Olsak.
 .\" vim: syntax=nroff