summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/pdftex.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-03-04 16:04:42 +0000
committerKarl Berry <karl@freefriends.org>2020-03-04 16:04:42 +0000
commit98e948a6f36458c4f2a1baca7bb3c1bb38c45d8a (patch)
tree4390afbf534f7e1352fc705a1407980111ca7eed /Master/texmf-dist/doc/man/man1/pdftex.1
parent4dfe4db11405cb8516021b486369a8acaf810334 (diff)
2020 man page updates
git-svn-id: svn://tug.org/texlive/trunk@54070 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/pdftex.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/pdftex.1120
1 files changed, 56 insertions, 64 deletions
diff --git a/Master/texmf-dist/doc/man/man1/pdftex.1 b/Master/texmf-dist/doc/man/man1/pdftex.1
index 450fcb18c5a..c091a0643ee 100644
--- a/Master/texmf-dist/doc/man/man1/pdftex.1
+++ b/Master/texmf-dist/doc/man/man1/pdftex.1
@@ -1,4 +1,4 @@
-.TH PDFTEX 1 "4 May 2016" "Web2C 2019"
+.TH PDFTEX 1 "6 August 2019" "Web2C 2020"
.\"=====================================================================
.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,10 +87,21 @@ 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.
.TP
+.BI -cnf-line \ string
+Parse
+.I string
+as a
+.I texmf.cnf
+configuration line. See the Kpathsea manual.
+.TP
.B -draftmode
Sets \epdfdraftmode so pdf\*(TX doesn't write a PDF and doesn't read any
included images, thus speeding up execution.
@@ -107,7 +111,7 @@ Enable the enc\*(TX extensions. This option is only effective in
combination with
.BR -ini .
For documentation of the enc\*(TX extensions see
-.BR http://www.olsak.net/enctex.html .
+http://www.olsak.net/enctex.html.
.TP
.B -etex
Enable the e-\*(TX extensions. This option is only effective in
@@ -208,16 +212,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 +256,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 +264,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 +289,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 +311,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 +323,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 +352,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 +407,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 +423,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 +458,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