From 4979745125b0dda8830bfdb81799242b9d225e51 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 4 Aug 2019 17:12:15 +0000 Subject: pdftex/web2c doc options and other updates git-svn-id: svn://tug.org/texlive/trunk@51815 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/web2c/ChangeLog | 4 + Build/source/texk/web2c/doc/web2c.info | 161 +++++++++++++++++---------------- Build/source/texk/web2c/doc/web2c.texi | 8 +- Build/source/texk/web2c/man/ChangeLog | 6 ++ Build/source/texk/web2c/man/pdftex.man | 111 ++++++++++------------- 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 + + * doc/web2c.texi (Shell escapes): default value no longer as stated. + 2019-07-19 Karl Berry * 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 + + * 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 * 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 -- cgit v1.2.3