summaryrefslogtreecommitdiff
path: root/Build/source/texk/web2c
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2024-03-02 16:15:36 +0000
committerKarl Berry <karl@freefriends.org>2024-03-02 16:15:36 +0000
commit053e4f0db456fdc2ede5350387e5a4c4789dd124 (patch)
tree461ca016392161dbe58ffd65a557c76a95e820cc /Build/source/texk/web2c
parent84598f376f95af544c5d638b16ebe76fe35d5519 (diff)
whitespace, \-, etc., from https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1065094
git-svn-id: svn://tug.org/texlive/trunk@70347 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c')
-rw-r--r--Build/source/texk/web2c/man/ChangeLog5
-rw-r--r--Build/source/texk/web2c/man/pdftex.man132
2 files changed, 72 insertions, 65 deletions
diff --git a/Build/source/texk/web2c/man/ChangeLog b/Build/source/texk/web2c/man/ChangeLog
index 267a2818644..4b1f6a1d88d 100644
--- a/Build/source/texk/web2c/man/ChangeLog
+++ b/Build/source/texk/web2c/man/ChangeLog
@@ -1,3 +1,8 @@
+2024-03-02 Bjarni Ingi Gislason <bjarniig@simnet.is>
+
+ * pdftex.man: whitespace, \-, etc. updates.
+ https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1065094
+
2024-02-21 Andreas Scherer <https://ascherer.github.io>
* ctwill.man,
diff --git a/Build/source/texk/web2c/man/pdftex.man b/Build/source/texk/web2c/man/pdftex.man
index 778701d6f16..5dbdabb12ea 100644
--- a/Build/source/texk/web2c/man/pdftex.man
+++ b/Build/source/texk/web2c/man/pdftex.man
@@ -1,4 +1,4 @@
-.TH PDFTEX 1 "24 August 2023" "Web2C @VERSION@"
+.TH PDFTEX 1 "2 March 2024" "Web2C @VERSION@"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF Metafont
@@ -7,17 +7,17 @@
.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP
.el .ds OX TeX
.\" BX definition must follow TX so BX can use TX
-.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
+.if t .ds BX \fRB\s-2IB\s+2\fP\*(TX
.if n .ds BX BibTeX
.\" LX definition must follow TX so LX can use TX
-.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
+.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s+2\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
.if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX
.if n .ds AX AmSTeX
.if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX
.if n .ds AY AmSLaTeX
.if n .ds WB Web
-.if t .ds WB W\s-2EB\s0
+.if t .ds WB W\s-2EB\s+2
.\"=====================================================================
.SH NAME
pdftex \- PDF output from TeX
@@ -32,16 +32,16 @@ Run the pdf\*(TX typesetter on
.IR file ,
usually creating
.IR file.pdf .
-If the file argument has no extension, ".tex" will be appended to it.
+If the file argument has no extension, ".tex" will be appended to it.
Instead of a filename, a set of pdf\*(TX commands can be given, the first
of which must start with a backslash.
-With a
+With a
.BI & format
argument pdf\*(TX uses a different set of precompiled commands,
contained in
.IR format\fB.fmt\fP ;
it is usually better to use the
-.B -fmt
+.B \-fmt
.I format
option instead.
.PP
@@ -58,7 +58,7 @@ command uses the equivalent of the plain \*(TX format, and the
.B pdflatex
command uses the equivalent of the \*(LX format.
To generate formats, use the
-.B -ini
+.B \-ini
switch.
.PP
The
@@ -81,7 +81,7 @@ In PDF mode, pdf\*(TX can natively handle the
and
.I PNG
graphics formats. pdf\*(TX cannot include PostScript or Encapsulated
-PostScript (EPS) graphics files; first convert them to PDF using
+PostScript (EPS) graphics files; first convert them to PDF using
.BR epstopdf (1).
pdf\*(TX's handling of its command-line arguments is similar to that
of the other \*(TX programs in the
@@ -95,47 +95,47 @@ extensions, and pdfe\*(TX is just a copy of pdf\*(TX. See
.SH OPTIONS
This version of pdf\*(TX understands the following command line options.
.TP
-.BI -cnf-line \ string
+.BI \-cnf-line \ string
Parse
.I string
as a
.I texmf.cnf
configuration line. See the Kpathsea manual.
.TP
-.B -draftmode
+.B \-draftmode
Sets \epdfdraftmode so pdf\*(TX doesn't write a PDF and doesn't read any
included images, thus speeding up execution.
.TP
-.B -enc
+.B \-enc
Enable the enc\*(TX extensions. This option is only effective in
combination with
-.BR -ini .
+.BR \-ini .
For documentation of the enc\*(TX extensions see
http://www.olsak.net/enctex.html.
.TP
-.B -etex
+.B \-etex
Enable the e-\*(TX extensions. This option is only effective in
combination with
-.BR -ini .
+.BR \-ini .
See
.BR etex (1).
.TP
-.B -file-line-error
+.B \-file-line-error
Print error messages in the form
.I file:line:error
which is similar to the way many compilers format them.
.TP
-.B -no-file-line-error
+.B \-no-file-line-error
Disable printing error messages in the
.I file:line:error
style.
.TP
-.B -file-line-error-style
+.B \-file-line-error-style
This is the old name of the
-.B -file-line-error
+.B \-file-line-error
option.
.TP
-.BI -fmt \ format
+.BI \-fmt \ format
Use
.I format
as the name of the format to be used, instead of the name by which
@@ -143,13 +143,13 @@ pdf\*(TX was called or a
.I %&
line.
.TP
-.B -halt-on-error
+.B \-halt-on-error
Exit with an error code when an error is encountered during processing.
.TP
-.B -help
+.B \-help
Print help message and exit.
.TP
-.B -ini
+.B \-ini
Start in
.I INI
mode, which is used to dump formats. The
@@ -157,7 +157,7 @@ mode, which is used to dump formats. The
mode can be used for typesetting, but no format is preloaded, and
basic initializations like setting catcodes may be required.
.TP
-.BI -interaction \ mode
+.BI \-interaction \ mode
Sets the interaction mode. The mode can be either
.IR batchmode ,
.IR nonstopmode ,
@@ -167,27 +167,27 @@ and
The meaning of these modes is the same as that of the corresponding
\ecommands.
.TP
-.B -ipc
+.B \-ipc
Send DVI or PDF output to a socket as well as the usual output file.
Whether this option is available is the choice of the installer.
.TP
-.B -ipc-start
+.B \-ipc-start
As
-.BR -ipc ,
+.BR \-ipc ,
and starts the server at the other end as well. Whether this option
is available is the choice of the installer.
.TP
-.BI -jobname \ name
+.BI \-jobname \ name
Use
.I name
for the job name, instead of deriving it from the name of the input file.
.TP
-.BI -kpathsea-debug \ bitmask
+.BI \-kpathsea-debug \ bitmask
Sets path searching debugging flags according to the bitmask. See the
.I Kpathsea
manual for details.
.TP
-.BI -mktex \ fmt
+.BI \-mktex \ fmt
Enable
.RI mktex fmt ,
where
@@ -197,11 +197,11 @@ must be either
or
.IR tfm .
.TP
-.B -mltex
+.B \-mltex
Enable ML\*(TX extensions. Only effective in combination with
-.BR -ini .
+.BR \-ini .
.TP
-.BI -no-mktex \ fmt
+.BI \-no-mktex \ fmt
Disable
.RI mktex fmt ,
where
@@ -211,20 +211,20 @@ must be either
or
.IR tfm .
.TP
-.BI -output-comment \ string
+.BI \-output-comment \ string
In DVI mode, use
.I string
for the DVI file comment instead of the date. This option is ignored in
PDF mode.
.TP
-.BI -output-directory \ directory
+.BI \-output-directory \ directory
Write output files in
.I directory
instead of the current directory. Look up input files in
.I directory
first, then along the normal search path.
.TP
-.BI -output-format \ format
+.BI \-output-format \ format
Set the output format mode, where
.I format
must be either
@@ -233,28 +233,28 @@ or
.IR dvi .
This also influences the set of graphics formats understood by pdf\*(TX.
.TP
-.B -parse-first-line
+.B \-parse-first-line
If the first line of the main input file begins with
.I %&
parse it to look for a dump name or a
-.B -translate-file
+.B \-translate-file
option.
.TP
-.B -no-parse-first-line
+.B \-no-parse-first-line
Disable parsing of the first line of the main input file.
.TP
-.BI -progname \ name
+.BI \-progname \ name
Pretend to be program
.IR name .
This affects both the format used and the search paths.
.TP
-.B -recorder
+.B \-recorder
Enable the filename recorder.
This leaves a trace of the files opened for input and output
in a file with extension
.IR .fls .
.TP
-.B -shell-escape
+.B \-shell-escape
Enable the
.RI \ewrite18{ command }
construct. The
@@ -262,23 +262,24 @@ construct. The
can be any shell command. This construct is normally
disallowed for security reasons.
.TP
-.B -no-shell-escape
+.B \-no-shell-escape
Disable the
.RI \ewrite18{ command }
construct, even if it is enabled in the
.I texmf.cnf
file.
.TP
-.B -shell-restricted
+.B \-shell-restricted
Enable restricted \ewrite18{}, as explained in the ``Shell escapes''
section of the Web2c Texinfo manual.
.TP
-.B -src-specials
-In DVI mode, insert source specials into the DVI file. This option is
-ignored in PDF mode.
+.B \-src-specials
+In DVI mode, insert source specials into the DVI file.
+This option is ignored in PDF mode.
.TP
-.BI -src-specials \ where
-In DVI mode, insert source specials in certain places of the DVI file. The
+.BI \-src-specials \ where
+In DVI mode, insert source specials in certain places of the DVI file.
+The
.I where
argument is a comma-separated value list:
.IR cr ,
@@ -291,28 +292,29 @@ or
.IR vbox .
This option is ignored in PDF mode.
.TP
-.BI -synctex \ NUMBER
-generate SyncTeX data for previewers according to bits of NUMBER. See the
+.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
+.BI \-translate-file \ tcxname
Use the
.I tcxname
translation table to set the mapping of input characters and
re-mapping of output characters.
.TP
-.BI -default-translate-file \ tcxname
+.BI \-default-translate-file \ tcxname
Like
-.B -translate-file
+.B \-translate-file
except that a
.I %&
line can overrule this setting.
.TP
-.B -version
+.B \-version
Print version information and exit.
.TP
-.B -8bit
+.B \-8bit
make all characters printable by default.
.\"=====================================================================
.SH ENVIRONMENT
@@ -324,9 +326,8 @@ 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 in \*(TX,
-and hence is expanded, not taken as part of the filename. Other
-programs, such as \*(MF, do not have this problem.
-.PP
+and hence is expanded, not taken as part of the filename.
+Other programs, such as \*(MF, do not have this problem.
.TP
.B TEXMFOUTPUT
Normally, pdf\*(TX puts its output files in the current directory. If
@@ -414,7 +415,7 @@ Predigested pdf\*(TX format (.\|fmt) files.
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
-DVI or PDF file will be invalid.
+DVI or PDF file will be invalid.
.\"=====================================================================
.SH AVAILABILITY
pdf\*(TX is available for a large variety of machine architectures
@@ -429,8 +430,8 @@ pdf\*(TX mailing list for all discussion: https://lists.tug.org/pdftex.
.\"=====================================================================
.SH "SEE ALSO"
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"
+documentation for this version of pdf\*(TX can be found in the
+.I "pdf\*(TX user manual"
and the Texinfo manuals
.IR "Kpathsea library" ,
.IR "Web2C: A TeX implementation" .
@@ -447,10 +448,11 @@ Some related programs:
.BR mf (1).
.\"=====================================================================
.SH AUTHORS
-The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka,
-Jiri Zlatuska, and Peter Breitenlohner (e\*(TX).
+The primary author of pdf\*(TX is Han The Thanh, with major
+contributions from Petr Sojka, Jiri Zlatuska, and Peter Breitenlohner
+(e\*(TX).
.PP
-\*(TX was designed by Donald E. Knuth,
+\*(TX was designed by Donald E.\& Knuth,
who implemented it using his \*(WB system for Pascal programs.
It was ported to Unix at Stanford by Howard Trickey, and
at Cornell by Pavel Curtis.