texlive[51815] Build/source/texk/web2c: pdftex/web2c doc options and
commits+karl at tug.org
commits+karl at tug.org
Sun Aug 4 19:12:15 CEST 2019
Revision: 51815
http://tug.org/svn/texlive?view=revision&revision=51815
Author: karl
Date: 2019-08-04 19:12:15 +0200 (Sun, 04 Aug 2019)
Log Message:
-----------
pdftex/web2c doc options and other updates
Modified Paths:
--------------
trunk/Build/source/texk/web2c/ChangeLog
trunk/Build/source/texk/web2c/doc/web2c.info
trunk/Build/source/texk/web2c/doc/web2c.texi
trunk/Build/source/texk/web2c/man/ChangeLog
trunk/Build/source/texk/web2c/man/pdftex.man
Modified: trunk/Build/source/texk/web2c/ChangeLog
===================================================================
--- trunk/Build/source/texk/web2c/ChangeLog 2019-08-04 12:29:26 UTC (rev 51814)
+++ trunk/Build/source/texk/web2c/ChangeLog 2019-08-04 17:12:15 UTC (rev 51815)
@@ -1,3 +1,7 @@
+2019-08-04 Karl Berry <karl at freefriends.org>
+
+ * doc/web2c.texi (Shell escapes): default value no longer as stated.
+
2019-07-19 Karl Berry <karl at tug.org>
* patgen.ch: mention adding swap/zram to deal with larger tries.
Modified: trunk/Build/source/texk/web2c/doc/web2c.info
===================================================================
--- trunk/Build/source/texk/web2c/doc/web2c.info 2019-08-04 12:29:26 UTC (rev 51814)
+++ trunk/Build/source/texk/web2c/doc/web2c.info 2019-08-04 17:12:15 UTC (rev 51815)
@@ -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 @@
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 @@
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 @@
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 @@
* \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 @@
* 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 @@
* 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 @@
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
Modified: trunk/Build/source/texk/web2c/doc/web2c.texi
===================================================================
--- trunk/Build/source/texk/web2c/doc/web2c.texi 2019-08-04 12:29:26 UTC (rev 51814)
+++ trunk/Build/source/texk/web2c/doc/web2c.texi 2019-08-04 17:12:15 UTC (rev 51815)
@@ -12,7 +12,7 @@
@end tex
@set version 2019
- at set month-year February 2019
+ at set month-year August 2019
@c Define new indices for commands in auxiliary files, filenames, and options.
@defcodeindex cm
@@ -1667,11 +1667,11 @@
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
Modified: trunk/Build/source/texk/web2c/man/ChangeLog
===================================================================
--- trunk/Build/source/texk/web2c/man/ChangeLog 2019-08-04 12:29:26 UTC (rev 51814)
+++ trunk/Build/source/texk/web2c/man/ChangeLog 2019-08-04 17:12:15 UTC (rev 51815)
@@ -1,3 +1,9 @@
+2019-08-04 Karl Berry <karl at 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,
Modified: trunk/Build/source/texk/web2c/man/pdftex.man
===================================================================
--- trunk/Build/source/texk/web2c/man/pdftex.man 2019-08-04 12:29:26 UTC (rev 51814)
+++ trunk/Build/source/texk/web2c/man/pdftex.man 2019-08-04 17:12:15 UTC (rev 51815)
@@ -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 @@
.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 @@
.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 @@
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 @@
.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 @@
.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 @@
.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,10 +282,13 @@
.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
.I tcxname
@@ -316,6 +304,9 @@
.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 @@
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 @@
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 @@
.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 @@
.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 @@
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
More information about the tex-live-commits
mailing list