⟦95c5aad1f⟧

TextFile

.TH DVITPS 1L "19 May 89"
.ds PS P\s-2OST\s+2S\s-2CRIPT\s+2
.SH "NAME"
dvitps \- convert a DVI file of TeX into a \*(PS file
.SH "SYNOPSIS"
.B dvitps
[ \fB\-qvwCDFLMSZ\fR ]
[ \fB\-c\fI number of copies\fR ]
[ \fB\-d\fI forward/reverse\fR ]
[ \fB\-f\fI from page-number\fR ]
[ \fB\-m\fI magnification\fR ]
[ \fB\-o\fI paper format\fR ]
[ \fB\-t\fI to page-number\fR ]
[ \fB\-z\fI reset page count\fR ]
[ \fB\-A\fI font file search path\fR ]
[ \fB\-B\fI capability file directory\fR ]
[ \fB\-H\fI horizontal offset\fR ]
[ \fB\-O\fI output file name\fR ]
[ \fB\-Q\fI number\fR ]
[ \fB\-R\fI resolution\fR ]
[ \fB\-V\fI vertical offset\fR ]
[ \fB\-X\fI horizontal fudge factor\fR ]
[ \fB\-Y\fI vertical fudge factor\fR ]
\fIfilename[.dvi] [-] \fR .\|.\|.
.SH "DESCRIPTION"
\fIdvitps(L)\fR is a DVI to \*(PS processor converting a TeX DVI file into a
\*(PS file. If more than one DVI file is listed one \*(PS file for
all the DVI files together is generated. Input from standard input is accepted
by specifying `-' as file name. The output appears on standard output
unless an output file is specified using the -O option.
.LP
.PP
The driver offers great facilities among them to include \*(PS figures with the
help of the psfig macro package, to generate figures with \fItpic(1)\fR and other
facilities which will be not discussed here. The driver, for instance, allows the user
to use GF, PK and PXL files. Also \*(PS fonts can be used in a document.
See the associated documentation which comes with this driver. This documentation
is mentioned at the end of this manual page.
.PP
The driver by default does not generate a "conforming document" so that,
for instance, TranScript's \fIpsrev(1)\fR could be used. The \-C option though
does cause the driver to generate a conforming document.
.PP
If you simply enter \fIdvitps\fR the driver will report all the available
options and the font files it recognizes at your installation plus the font
paths it uses to locate all fonts.
.SH "OPTIONS"
.TP
.B \-c \fInumber of copies\fR
Specifies the number of copies to print. Each page is printed \fInumber of
copies\fR times, and the pages have to be collated by hand.
.TP
.B \-d \fIdirection\fR
The direction is either \fIforward\fR or \fIbackward\fR and the generated \*(PS output
file prints in the specified direction. The default is
\*(OD
.TP
.B \-f \fIpage number\fR
Start output with the specified page number.
.TP
.B \-m \fImagnification\fR
Magnify the document by the given \fImagnification factor\fR which can be 0 through 5
(\\magsteps 0 through 5, and h (for \\magstephalf). Any other number is interpreted
as a TeX magnification (1000 times the desired magnification).
.TP
.B \-o \fIpaper format\fR
The \fIpaper format\fR instruction tells the \*(PS printer which type of
paper the output occurs on. Legal values are \fIletter\fR, \fIlegal\fR and \fInote\fR
where \fIletter\fR is the default.
.TP
.B \-q
Quiet: do not print any messages while processing a DVI file. See also the \-v
option.
.TP
.B \-t \fIpage number\fR
Generate output only until the specified page number is reached.
.TP
.B \-v
Verbose: print extensive messages while processing the DVI files. See also the \-q
option. The default is somewhere between \-q and this option.
.TP
.B \-w
Do not generate a width vector for any of the \*(PS fonts. This reduces the usage
of virtual memory inside the \*(PS printer by a factor of 50% but it also makes the
driver not follow the rules of \fIdvitype\fR, the master driver program, precisely. The
usage of this option is discouraged but it causes also a shorter \*(PS file to
be generated.
.TP
.B \-z \fIreset page count\fR
Generate \*(PS code which encloses every block of \fIreset page count\fR pages
into a separate save restore pair. This option is incompatible with the \-C option.
.TP
.B \-A \fIfont file search path\fR
Use \fIfont file search path\fR as the search path to locate all the font files like the
GF, PK, PXL or PDR files. Any environment variables related to locating fonts are ignored
in this case. See below for those environment variables.
.TP
.B \-B \fIcapability file directory\fR
Use the specified directory to locate the capability file. This file is normally
expected to be in directory DVITPS_CAP_DIR. The file name of this file is dvitps-cap.
.TP
.B \-D
Print ``Draft'' on top of each page including name of DVI file and generation date
of DVI file.
.TP
.B \-F
Show the search operations of the driver to locate GF, PK, PXL or PDR files.
.TP
.B \-H \fIhorizontal offset\fR
Shift the final output by \fIhorizontal offset\fR to the right (if positive) or to
the left (if negative). The value of \fIhorizontal offset\fR must be immediately
(without intervening space) followed by one of TeX's dimension unit such as pt (points)
or in (inch). All other dimension units of TeX are acceptable too.
.TP
.B \-L
Print the whole job in landscape mode.
.TP
.B \-M
Expect manual feed when printing; this generates a manualfeed instruction in \*(PS.
.TP
.B \-O \fIoutput file\fR
The \*(PS file is written to the specified file instead of standard output which is the default.
.TP
.B \-Q \fInumber\fR
This option is used to invoke certain test functions. They will not be documented
here any further. See the description of the driver in the manual for details.
.TP
.B \-R \fIresolution\fR
Specifies the resolution of the \*(PS printer on which the output
will occur. The default is 300 dots/inch.
.TP
.B \-S
The driver may safely assume that only characters with character code less than
128 are used in \*(PS fonts. In case this turns out to be not
true the driver will generate a fatal error. The main effect of this
option is to shorten the length of the generated \*(PS code.
.TP
.B \-V \fIvertical offset\fR
Shift the final output by \fIvertical offset\fR down (if positive) or up
(if negative). The value of \fIvertical offset\fR must be immediately
followed (without intervening space) by a dimension unit which must be one of pt (point),
in (inch), mm (millimeter) or cm (centimeter).
.TP
.B \-X \fIhorizontal fudge factor\fR
Stretch or shrink any output in the X direction (that is horizontally) by
\fIhorizontal fudge factor\fR.
.TP
.B \-Y \fIvertical fudge factor\fR
Stretch or shrink any output in the Y direction (that is vertically) by
\fIvertical fudge factor\fR.
.TP
.B \-Z
Causes all special's to be ignored. Therefore all \fItpic\fR and psfig based
figures are ignored.
.SH "ENVIRONMENT VARIABLES"
We will now briefly discuss the environment variables understood by the
driver.
.TP
.B TEXFONTS_DVITPS_GF
This environment variable can be used to specify a special search path for GF files.
If this variable is not set see below for details.
If the \-A option of the driver is used this
environment variable as any other font path related environment variable is ignored.
.TP
.B TEXFONTS_DVITPS_PK
Similar to TEXFONTS_DVITPS_GF this environment variable can be used to specify a search
path for PK files only.
If the \-A option of this driver is used this
environment variable as any other font path related environment variable is ignored.
.TP
.B TEXFONTS_DVITPS_PXL
Similar to TEXFONTS_DVITPS_GF this environment variable can be used to specify a search
path for PXL files only.
If the \-A option of this driver is used this
environment variable as any other font path related environment variable is ignored.
.TP
.B TEXFONTS_DVITPS_PDR
Similar to TEXFONTS_DVITPS_GF this environment variable can be used to specify a search
path for PDR files. PDR files are accessed by the driver in the case of \*(PS fonts.
If the \-A option of this driver is used this
environment variable as any other font path related environment variable is ignored.
.TP
.B TEXFONTS_DVITPS
This envrionment variable determines the search path if none of the above environment
variables is set or the \-A option of the driver is not used.
.TP
.B TEXFONTS
This envrionment variable is used if none of the above environment variables are
set or the \-A option of the driver is used. This environment variable is typically the
environment variable used to determine the search path for font files.
If even this environment variale is not set then a default will be used
which in the case of this installation is TEXFONTS_DEF.
.TP
.B DVITPS_PROLOGUE_FILES_PATH
This environment variable can be used to overwrite the default for the search
path to locate \*(PS prologue files. Prologue files have the file extension .pro.
The default path in effect when this environment variable is not set is
DVITPS_PROLOGUE_FILES_PATH_DEF.
.SH "FILES"
The prologue \*(PS files of this driver are installed in
DRIVER_PS_PROLOGUE_FILES_DIR. See the description of the environment
variable DVITPS_PROLOGUE_FILES_PATH for additional information.
.PP
Each time the driver is started up it looks for the file .dvitps-opt
in the current directory. If it can find this file it assumes that it contains command line options.
The options specified in this file will be used before any of the command line options
given by the user will be evaluated. For instance, if this file contains \-D then this
option will be applied to all DVI files printed in this directory, and therefore
all options will contain a "draft stamp."
.SH "DIAGNOSTICS"
Check the \-F, \-v and \-q options above.
.SH "SEE ALSO"
dvitype(l), pfd2tfm(l), printpdr(l)
.PP
Stephan v. Bechtolsheim, "\fITeXPS - A TeX \*(PS Software Package"\fR,
Report 89-TeXPS-1, Integrated Computer Software, Inc, 1989. This report
contains the full description of this software and is highly recommended
for further study of the driver. In particular in contains an explanation of
how to use \*(PS fonts in a document, how to include \*(PS figures with
the help of psfig etc. Also this report is a test document: once you
were able to reproduce this document locally on your machine you can
be pretty confident that the software works like promised.
.SH "BUGS"
You find them, I fix them.
.SH "AUTHOR"
Stephan v. Bechtolsheim, Integrated Computer Software, Inc

DataMuseum.dk

DKUUG/EUUG Conference tapes

⟦95c5aad1f⟧ TextFile

Derivation

TextFile