summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/pdftex.1
diff options
context:
space:
mode:
authorPeter Breitenlohner <peb@mppmu.mpg.de>2010-05-19 08:40:53 +0000
committerPeter Breitenlohner <peb@mppmu.mpg.de>2010-05-19 08:40:53 +0000
commite9a2a190f6ce2e9e0027affddb6022f977bbf766 (patch)
tree9bdbbadcbaeff10bd7cba344bb2538873d72e7f3 /Master/texmf/doc/man/man1/pdftex.1
parent324f853c7ef10cf23765b740f3a2f5a6164ad426 (diff)
update manpages
git-svn-id: svn://tug.org/texlive/trunk@18350 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/man/man1/pdftex.1')
-rw-r--r--Master/texmf/doc/man/man1/pdftex.145
1 files changed, 24 insertions, 21 deletions
diff --git a/Master/texmf/doc/man/man1/pdftex.1 b/Master/texmf/doc/man/man1/pdftex.1
index b1e9880fc87..2bdb6454b78 100644
--- a/Master/texmf/doc/man/man1/pdftex.1
+++ b/Master/texmf/doc/man/man1/pdftex.1
@@ -1,4 +1,4 @@
-.TH PDFTEX 1 "8 January 2007" "pdftex 1.40" "Web2C 2009"
+.TH PDFTEX 1 "14 May 2010" "pdftex 1.40" "Web2C 2010/pretest"
.\"=====================================================================
.if n .ds MF Metafont
.if t .ds MF M\s-2ETAFONT\s0
@@ -27,8 +27,8 @@ pdftex, pdfinitex, pdfvirtex \- PDF output from TeX
.SH SYNOPSIS
.B pdftex
.RI [ options ]
-[\fB&\fR \fIformat\fR ]
-[ \fIfile\fR | \fB\e\fR \fIcommands\fR ]
+.RI [ \fB&\fPformat ]
+.RI [ file | \fB\e\fPcommands ]
.\"=====================================================================
.SH DESCRIPTION
Run the pdf\*(TX typesetter on
@@ -42,7 +42,7 @@ With a
.BI & format
argument pdf\*(TX uses a different set of precompiled commands,
contained in
-.IR format.fmt ;
+.IR format\fB.fmt\fP ;
it is usually better to use the
.B -fmt
.I format
@@ -242,7 +242,8 @@ in
mode.
.TP
.BI -output-directory \ directory
-.rb Write output files in
+.rb
+Write output files in
.I directory
instead of the current directory. Look up input files in
.I directory
@@ -364,48 +365,51 @@ expanded, not taken as part of the filename. Other programs, such as
\*(MF, do not have this problem.
.PP
.TP
-TEXMFOUTPUT
+.B TEXMFOUTPUT
Normally, pdf\*(TX puts its output files in the current directory. If
any output file cannot be opened there, it tries to open it in the
directory specified in the environment variable TEXMFOUTPUT.
There is no default value for that variable. For example, if you say
.I pdftex paper
-and the current directory is not writable, if TEXMFOUTPUT has
+and the current directory is not writable and TEXMFOUTPUT has
the value
.IR /tmp ,
pdf\*(TX attempts to create
.I /tmp/paper.log
(and
.IR /tmp/paper.pdf ,
-if any output is produced.)
+if any output is produced.) TEXMFOUTPUT is also checked for input
+files, as \*(TX often generates files that need to be subsequently
+read; for input, no suffixes (such as ``.tex'') are added by default,
+the input name is simply checked as given.
.TP
-TEXINPUTS
+.B TEXINPUTS
Search path for
.I \einput
and
.I \eopenin
files.
-This should probably start with ``.'', so
+This should start 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
-file. For example, set TEXINPUTS to ".:/home/usr/tex:" to prepend the
+file. For example, set TEXINPUTS to ".:/home/user/tex:" to prepend the
current directory and ``/home/user/tex'' to the standard search path.
.TP
-TEXFORMATS
+.B TEXFORMATS
Search path for format files.
.TP
-TEXPOOL
+.B TEXPOOL
search path for
.B pdftex
internal strings.
.TP
-TEXEDIT
+.B TEXEDIT
Command template for switching to editor. The default, usually
.BR vi ,
is set when pdf\*(TX is compiled.
.TP
-TFMFONTS
+.B TFMFONTS
Search path for font metric
.RI ( .tfm )
files.
@@ -465,7 +469,7 @@ Information on how to get pdf\*(TX and related information
is available at the
.B http://www.pdftex.org
.IR "pdf\*(TX"
-website.
+web site.
.P
The following pdfe\*(TX related mailing list is available:
.BR pdftex@tug.org .
@@ -474,10 +478,9 @@ to subscribe send a message containing
.I subscribe
to
.BR pdftex-request@tug.org .
-More about the list can be found at the
-.B "http://tug.org/mailman/listinfo/pdftex"
-.I mailing list
-website.
+A web interface and list archives can be found at the
+.B "http://lists.tug.org/pdftex"
+mailing list web site.
.\"=====================================================================
.SH "SEE ALSO"
.BR epstopdf (1),
@@ -485,8 +488,8 @@ website.
.BR latex (1),
.BR mptopdf (1),
.BR tex (1),
-.BR texexec (1),
.BR mf (1).
+http://tug.org/applications/pdftex, http://tug.org/web2c.
.\"=====================================================================
.SH AUTHORS
The primary authors of pdf\*(TX are Han The Thanh, Petr Sojka,