| 1 |
.TH DVIPS 1 "24 October 2021" |
| 2 |
.SH NAME |
| 3 |
dvips \- convert a TeX DVI file to PostScript |
| 4 |
.SH SYNOPSIS |
| 5 |
.B dvips |
| 6 |
.RI [ OPTIONS ] |
| 7 |
.IR file [\fB.dvi\fP] |
| 8 |
.SH DESCRIPTION |
| 9 |
THIS MAN PAGE IS OBSOLETE! |
| 10 |
See the Texinfo documentation instead. |
| 11 |
You can read it either in Emacs or with the standalone |
| 12 |
.B info |
| 13 |
program. |
| 14 |
.PP |
| 15 |
The program |
| 16 |
.B dvips |
| 17 |
takes a DVI file |
| 18 |
.IR file [\fB.dvi\fP] |
| 19 |
produced by TeX (or by some other processor such as GFtoDVI) and |
| 20 |
converts it to PostScript, sending the output to a file or directly to a |
| 21 |
printer. The DVI file may be specified without the |
| 22 |
.B .dvi |
| 23 |
extension. Fonts used may either be resident in the printer or defined |
| 24 |
as bitmaps in PK files, or a `virtual' combination of both. If the |
| 25 |
.B mktexpk |
| 26 |
program is installed, |
| 27 |
.B dvips |
| 28 |
will automatically invoke METAFONT to generate fonts that don't already |
| 29 |
exist. |
| 30 |
.PP |
| 31 |
For more information, see the Texinfo manual |
| 32 |
.IR dvips.texi , |
| 33 |
which should be installed somewhere on your system, hopefully accessible |
| 34 |
through the standard Info tree. |
| 35 |
.SH OPTIONS |
| 36 |
.TP |
| 37 |
.B -a |
| 38 |
Conserve memory by making three passes over the .dvi file instead of two |
| 39 |
and only loading those characters actually used. Generally only useful |
| 40 |
on machines with a very limited amount of memory, like some PCs. |
| 41 |
.TP |
| 42 |
.B -A |
| 43 |
Print only odd pages (TeX pages, not sequence pages). |
| 44 |
.TP |
| 45 |
.B -b num |
| 46 |
Generate |
| 47 |
.I num |
| 48 |
copies of each page, but duplicating the page body rather than using the |
| 49 |
.I #numcopies |
| 50 |
option. This can be useful in conjunction with a header file setting |
| 51 |
.I \ebop-hook |
| 52 |
to do color separations or other neat tricks. |
| 53 |
.TP |
| 54 |
.B -B |
| 55 |
Print only even pages (TeX pages, not sequence pages). |
| 56 |
.TP |
| 57 |
.B -c num |
| 58 |
Generate |
| 59 |
.I num |
| 60 |
copies of every page. Default is 1. (For collated copies, see the |
| 61 |
.I -C |
| 62 |
option below.) |
| 63 |
.TP |
| 64 |
.B -C num |
| 65 |
Create |
| 66 |
.I num |
| 67 |
copies, but collated (by replicating the data in the PostScript file). |
| 68 |
Slower than the |
| 69 |
.I -c |
| 70 |
option, but easier on the hands, and faster than resubmitting the same |
| 71 |
PostScript file multiple times. |
| 72 |
.TP |
| 73 |
.B -d num |
| 74 |
Set the debug flags. This is intended only for emergencies or for |
| 75 |
unusual fact-finding expeditions; it will work only if |
| 76 |
.B dvips |
| 77 |
has been compiled with the DEBUG option. If nonzero, prints additional |
| 78 |
information on standard error. For maximum information, you can use |
| 79 |
`-1'. See the Dvips Texinfo manual for more details. |
| 80 |
.TP |
| 81 |
.B -D num |
| 82 |
Set the resolution in dpi (dots per inch) to |
| 83 |
.IR num . |
| 84 |
This affects the choice of bitmap fonts that are loaded and also the |
| 85 |
positioning of letters in resident PostScript fonts. Must be between 10 |
| 86 |
and 10000. This affects both the horizontal and vertical resolution. |
| 87 |
If a high resolution (something greater than 400 dpi, say) is selected, |
| 88 |
the |
| 89 |
.I -Z |
| 90 |
flag should probably also be used. |
| 91 |
.TP |
| 92 |
.B -e num |
| 93 |
Make sure that each character is placed at most this many pixels from |
| 94 |
its `true' resolution-independent position on the page. The default |
| 95 |
value of this parameter is resolution dependent. Allowing individual |
| 96 |
characters to `drift' from their correctly rounded positions by a few |
| 97 |
pixels, while regaining the true position at the beginning of each new |
| 98 |
word, improves the spacing of letters in words. |
| 99 |
.TP |
| 100 |
.B -E |
| 101 |
makes |
| 102 |
.B dvips |
| 103 |
attempt to generate an EPSF file with a tight bounding box. This only |
| 104 |
works on one-page files, and it only looks at marks made by characters |
| 105 |
and rules, not by any included graphics. In addition, it gets the glyph |
| 106 |
metrics from the |
| 107 |
.I tfm |
| 108 |
file, so characters that lie outside their enclosing |
| 109 |
.I tfm |
| 110 |
box may confuse it. In addition, the bounding box might be a bit too |
| 111 |
loose if the character glyph has significant left or right side |
| 112 |
bearings. Nonetheless, this option works well for creating small EPSF |
| 113 |
files for equations or tables or the like. (Note, of course, that |
| 114 |
.B dvips |
| 115 |
output is resolution dependent and thus does not make very good EPSF |
| 116 |
files, especially if the images are to be scaled; use these EPSF files |
| 117 |
with a great deal of care.) |
| 118 |
.TP |
| 119 |
.B -f |
| 120 |
Run as a filter. Read the |
| 121 |
.I .dvi |
| 122 |
file from standard input and write the PostScript to standard output. |
| 123 |
The standard input must be seekable, so it cannot be a pipe. If you |
| 124 |
must use a pipe, write a shell script that copies the pipe output to a |
| 125 |
temporary file and then points |
| 126 |
.B dvips |
| 127 |
at this file. This option also disables the automatic reading of the |
| 128 |
.I PRINTER |
| 129 |
environment variable, and turns off the automatic sending of control D |
| 130 |
if it was turned on with the |
| 131 |
.I -F |
| 132 |
option or in the configuration file; use |
| 133 |
.I -F |
| 134 |
after this option if you want both. |
| 135 |
.TP |
| 136 |
.B -F |
| 137 |
Causes Control-D (ASCII code 4) to be appended as the very last |
| 138 |
character of the PostScript file. This is useful when |
| 139 |
.B dvips |
| 140 |
is driving the printer directly instead of working through a spooler, |
| 141 |
as is common on extremely small systems. NOTE! DO NOT USE THIS OPTION! |
| 142 |
.TP |
| 143 |
.B -G |
| 144 |
Causes |
| 145 |
.B dvips |
| 146 |
to shift non-printing characters to higher-numbered positions. |
| 147 |
This may be useful sometimes. |
| 148 |
.TP |
| 149 |
.B -h name |
| 150 |
Prepend file |
| 151 |
.I name |
| 152 |
as an additional header file. (However, if the name is simply `-' |
| 153 |
suppress all header files from the output.) This header file gets added |
| 154 |
to the PostScript |
| 155 |
.IR userdict . |
| 156 |
.TP |
| 157 |
.B -i |
| 158 |
Make each section be a separate file. Under certain circumstances, |
| 159 |
.B dvips |
| 160 |
will split the document up into `sections' to be processed |
| 161 |
independently; this is most often done for memory reasons. Using this |
| 162 |
option tells |
| 163 |
.B dvips |
| 164 |
to place each section into a separate file; the new file names are |
| 165 |
created replacing the suffix of the supplied output file name by a |
| 166 |
three-digit sequence number. This option is most often used in |
| 167 |
conjunction with the |
| 168 |
.I -S |
| 169 |
option which sets the maximum section length in pages. For instance, |
| 170 |
some phototypesetters cannot print more than ten or so consecutive pages |
| 171 |
before running out of steam; these options can be used to automatically |
| 172 |
split a book into ten-page sections, each to its own file. |
| 173 |
.TP |
| 174 |
.B -j |
| 175 |
Download only needed characters from Type 1 fonts. This is the |
| 176 |
default in the current release. Some debugging flags trace this operation. |
| 177 |
You can also control partial downloading on a per-font basis, via the |
| 178 |
.B psfonts.map |
| 179 |
file. |
| 180 |
.TP |
| 181 |
.B -k |
| 182 |
Print crop marks. This option increases the paper size (which should be |
| 183 |
specified, either with a paper size special or with the |
| 184 |
.I -T |
| 185 |
option) by a half inch in each dimension. It translates each page by a |
| 186 |
quarter inch and draws cross-style crop marks. It is mostly useful with |
| 187 |
typesetters that can set the page size automatically. |
| 188 |
.TP |
| 189 |
.B -K |
| 190 |
This option causes comments in included PostScript graphics, font files, |
| 191 |
and headers to be removed. This is sometimes necessary to get around |
| 192 |
bugs in spoolers or PostScript post-processing programs. Specifically, |
| 193 |
the %%Page comments, when left in, often cause difficulties. Use of |
| 194 |
this flag can cause some included graphics to fail, since the PostScript |
| 195 |
header macros from some software packages read portions of the input |
| 196 |
stream line by line, searching for a particular comment. This option |
| 197 |
has been turned off by default because PostScript previewers and |
| 198 |
spoolers have been getting better. |
| 199 |
.TP |
| 200 |
.B -l num |
| 201 |
The last page printed will be the first one numbered |
| 202 |
.I num |
| 203 |
Default is the last page in the document. If the |
| 204 |
.I num |
| 205 |
is prefixed by an equals sign, then it (and any argument to the |
| 206 |
.I -p |
| 207 |
option) is treated as a sequence number, rather than a value to compare |
| 208 |
with |
| 209 |
.I \ecount0 |
| 210 |
values. Thus, using |
| 211 |
.I -l =9 |
| 212 |
will end with the ninth page of the document, no matter what the pages |
| 213 |
are actually numbered. On the other hand, if |
| 214 |
.I num |
| 215 |
is suffixed by `.SEQ', the SEQth occurrence of |
| 216 |
.I num |
| 217 |
is used; for example, |
| 218 |
.I -l 99.2 |
| 219 |
says to end processing with the second page numbered 99 in the document. |
| 220 |
.TP |
| 221 |
.B -m |
| 222 |
Specify manual feed for printer. |
| 223 |
.TP |
| 224 |
.B -mode mode |
| 225 |
Use |
| 226 |
.I mode |
| 227 |
as the Metafont device name for path searching and font |
| 228 |
generation. This overrides any value from configuration files. With |
| 229 |
the default paths, explicitly specifying the mode also makes the program |
| 230 |
assume the fonts are in a subdirectory named |
| 231 |
.IR mode . |
| 232 |
.TP |
| 233 |
.B -M |
| 234 |
Turns off the automatic font generation facility. If any fonts are |
| 235 |
missing, commands to generate the fonts are appended to the file |
| 236 |
.I missfont.log |
| 237 |
in the current directory; this file can then be executed and deleted to |
| 238 |
create the missing fonts. |
| 239 |
.TP |
| 240 |
.B -n num |
| 241 |
At most |
| 242 |
.I num |
| 243 |
pages will be printed. Default is 100000. |
| 244 |
.TP |
| 245 |
.B -N |
| 246 |
Turns off structured comments; this might be necessary on some systems |
| 247 |
that try to interpret PostScript comments in weird ways, or on some |
| 248 |
PostScript printers. Old versions of TranScript in particular cannot |
| 249 |
handle modern Encapsulated PostScript. |
| 250 |
.TP |
| 251 |
.BR -noomega |
| 252 |
This will disable the use of Omega extensions when interpreting DVI |
| 253 |
files. By default, the additional opcodes |
| 254 |
.I 129 |
| 255 |
and |
| 256 |
.I 134 |
| 257 |
are recognized by dvips as Omega or pTeX extensions and interpreted as |
| 258 |
requests to set 2-byte characters. |
| 259 |
.TP |
| 260 |
.BR -noptex |
| 261 |
This will disable the use of pTeX extensions when interpreting DVI files. |
| 262 |
By default, the additional opcodes |
| 263 |
.I 130 |
| 264 |
and |
| 265 |
.I 135 |
| 266 |
are recognized by dvips as pTeX extensions and interpreted as requests to |
| 267 |
set 3-byte characters, and |
| 268 |
.I 255 |
| 269 |
as request to change the typesetting direction. |
| 270 |
.sp |
| 271 |
The only drawback is that the virtual font array will (at least temporarily) |
| 272 |
require 65536 or more positions instead of the default 256 positions, i.e., |
| 273 |
the memory requirements of dvips will be somewhat larger. If you find this |
| 274 |
unacceptable or encounter another problem with the Omega or pTeX extensions, |
| 275 |
you can switch off the pTeX extension by using |
| 276 |
.BR -noptex , |
| 277 |
or both by using |
| 278 |
.B -noomega |
| 279 |
(but please do send a bug report if you find such problems - see the bug |
| 280 |
address in the |
| 281 |
.B AUTHORS |
| 282 |
section below). |
| 283 |
.TP |
| 284 |
.B -o name |
| 285 |
The output will be sent to file |
| 286 |
.I name |
| 287 |
If no file name is given (i.e., -o is last on the command line), the |
| 288 |
default name is |
| 289 |
.I file.ps |
| 290 |
where the .dvi file was called |
| 291 |
.IR file.dvi ; |
| 292 |
if this option isn't given, any default in the configuration file is |
| 293 |
used. If the first character of the supplied output file name is an |
| 294 |
exclamation mark, then the remainder will be used as an argument to |
| 295 |
.IR popen ; |
| 296 |
thus, specifying |
| 297 |
.I !lpr |
| 298 |
as the output file will automatically queue the file for printing. |
| 299 |
This option also disables the automatic reading of the |
| 300 |
.I PRINTER |
| 301 |
environment variable, and turns off the automatic sending of control D |
| 302 |
if it was turned on with the |
| 303 |
.I -F |
| 304 |
option or in the configuration file; use |
| 305 |
.I -F |
| 306 |
after this option if you want both. |
| 307 |
.TP |
| 308 |
.B -O offset |
| 309 |
Move the origin by a certain amount. The |
| 310 |
.I offset |
| 311 |
is a comma-separated pair of dimensions, such as |
| 312 |
.I .1in,-.3cm |
| 313 |
(in the same syntax used in the |
| 314 |
.I papersize |
| 315 |
special). The origin of the page is shifted from the |
| 316 |
default position (of one inch down, one inch to the right from the upper |
| 317 |
left corner of the paper) by this amount. |
| 318 |
.TP |
| 319 |
.B -p num |
| 320 |
Just like |
| 321 |
.I -l |
| 322 |
but for the first page in the document. |
| 323 |
.TP |
| 324 |
.B -pp pagelist |
| 325 |
A comma-separated list of pages and ranges (a-b) may be given, which |
| 326 |
will be interpreted as |
| 327 |
.I \ecount0 |
| 328 |
values. Pages not specified will not be printed. Multiple |
| 329 |
.B -pp |
| 330 |
options may be specified or all pages and page ranges can be |
| 331 |
specified with one |
| 332 |
.B -pp |
| 333 |
option. |
| 334 |
.TP |
| 335 |
.B -P printername |
| 336 |
Sets up the output for the appropriate printer. This is implemented by |
| 337 |
reading in |
| 338 |
.I config.printername |
| 339 |
, which can then set the output pipe (as in, |
| 340 |
.I !lpr -Pprintername |
| 341 |
as well as the font paths and any other |
| 342 |
.I config.ps |
| 343 |
defaults for that printer only. Note that |
| 344 |
.I config.ps |
| 345 |
is read before |
| 346 |
.I config.printername |
| 347 |
In addition, another file called |
| 348 |
.I ~/.dvipsrc |
| 349 |
is searched for immediately after |
| 350 |
.IR config.ps ; |
| 351 |
this file is intended for user defaults. If no |
| 352 |
.I -P |
| 353 |
command is given, the environment variable |
| 354 |
.I PRINTER |
| 355 |
is checked. If that variable exists, and a corresponding configuration |
| 356 |
file exists, that configuration file is read in. |
| 357 |
.TP |
| 358 |
.B -q |
| 359 |
Run in quiet mode. Don't chatter about pages converted, etc.; report |
| 360 |
nothing but errors to standard error. |
| 361 |
.TP |
| 362 |
.B -r |
| 363 |
Stack pages in reverse order. Normally, page 1 will be printed first. |
| 364 |
.TP |
| 365 |
.B -R[0|1|2] |
| 366 |
Run securely. |
| 367 |
.BR -R2 |
| 368 |
disables both shell command execution in |
| 369 |
.I \especial'{} |
| 370 |
(via backticks |
| 371 |
.BR ` |
| 372 |
) and config files (via the |
| 373 |
.I E |
| 374 |
option), and opening of any absolute filenames. |
| 375 |
.BR -R1 |
| 376 |
, the default, forbids shell escapes but allows absolute filenames. |
| 377 |
.BR -R0 |
| 378 |
allows both. The config file option is |
| 379 |
.I z |
| 380 |
.TP |
| 381 |
.B -s |
| 382 |
Causes the entire global output to be enclosed in a save/restore pair. |
| 383 |
This causes the file to not be truly conformant, and is thus not |
| 384 |
recommended, but is useful if you are driving the printer directly and |
| 385 |
don't care too much about the portability of the output. |
| 386 |
.TP |
| 387 |
.B -S num |
| 388 |
Set the maximum number of pages in each `section'. This option is most |
| 389 |
commonly used with the |
| 390 |
.I -i |
| 391 |
option; see that documentation above for more information. |
| 392 |
.TP |
| 393 |
.B -t papertype |
| 394 |
This sets the paper type to |
| 395 |
.IR papertype . |
| 396 |
The |
| 397 |
.I papertype |
| 398 |
should be defined in one of the configuration files, along with the |
| 399 |
appropriate code to select it. (Currently known types include |
| 400 |
.BR letter , |
| 401 |
.BR legal , |
| 402 |
.BR ledger , |
| 403 |
.BR a4 , |
| 404 |
.BR a3 ). |
| 405 |
You can also specify |
| 406 |
.BR -t " " landscape , |
| 407 |
which rotates a document by 90 degrees. To rotate a document whose size |
| 408 |
is not letter, you can use the |
| 409 |
.I -t |
| 410 |
option twice, once for the page size, and once for landscape. |
| 411 |
You should not use any |
| 412 |
.I -t |
| 413 |
option when the DVI file already contains a |
| 414 |
.I papersize |
| 415 |
special, as is done by some LaTeX packages, notably hyperref.sty. |
| 416 |
|
| 417 |
The upper left corner of each page in the |
| 418 |
.I .dvi |
| 419 |
file is placed one inch from the left and one inch from the top. Use of |
| 420 |
this option is highly dependent on the configuration file. Note that |
| 421 |
executing the |
| 422 |
.B letter |
| 423 |
or |
| 424 |
.B a4 |
| 425 |
or other PostScript operators cause the document to be nonconforming and |
| 426 |
can cause it not to print on certain printers, so the paper size should |
| 427 |
not execute such an operator if at all possible. |
| 428 |
.TP |
| 429 |
.B -T papersize |
| 430 |
Set the paper size to the given pair of dimensions. This option takes |
| 431 |
its arguments in the same style as |
| 432 |
.IR -O . |
| 433 |
It overrides any paper size special in the dvi file. |
| 434 |
.TP |
| 435 |
.B -u psmapfile |
| 436 |
Set |
| 437 |
.I psmapfile |
| 438 |
to be the file that dvips uses for looking up PostScript font aliases. If |
| 439 |
.I psmapfile |
| 440 |
begins with a |
| 441 |
.B + |
| 442 |
character, then the rest of the name is used as the name of the map file, |
| 443 |
and the map file is appended to the list of map files (instead of replacing |
| 444 |
the list). In either case, if |
| 445 |
.I psmapfile |
| 446 |
has no extension, then |
| 447 |
.B .map |
| 448 |
is added at the end. |
| 449 |
.TP |
| 450 |
.B -U |
| 451 |
Disable a PostScript virtual memory saving optimization that stores the |
| 452 |
character metric information in the same string that is used to store |
| 453 |
the bitmap information. This is only necessary when driving the Xerox |
| 454 |
4045 PostScript interpreter. It is caused by a bug in that interpreter |
| 455 |
that results in `garbage' on the bottom of each character. Not |
| 456 |
recommended unless you must drive this printer. |
| 457 |
.TP |
| 458 |
.B -v |
| 459 |
Print the |
| 460 |
.B dvips |
| 461 |
version number and exit. |
| 462 |
.TP |
| 463 |
.B -V |
| 464 |
Download non-resident PostScript fonts as bitmaps. This requires use of |
| 465 |
`gsftopk' or `pstopk' or some other such program(s) in order to generate |
| 466 |
the required bitmap fonts; these programs are supplied with |
| 467 |
.BR dvips . |
| 468 |
.TP |
| 469 |
.B -x num |
| 470 |
Set the |
| 471 |
magnification ratio to |
| 472 |
.IR num /1000. |
| 473 |
Overrides the magnification specified in the .dvi file. Must be |
| 474 |
between 10 and 100000. Instead of an integer, |
| 475 |
.I num |
| 476 |
may be a real number for increased precision. |
| 477 |
.TP |
| 478 |
.B -X num |
| 479 |
Set the horizontal resolution in dots per inch to |
| 480 |
.IR num . |
| 481 |
.TP |
| 482 |
.B -y num |
| 483 |
Set the |
| 484 |
magnification ratio to |
| 485 |
.IR num /1000 |
| 486 |
times the magnification specified in the .dvi file. |
| 487 |
See |
| 488 |
.B -x |
| 489 |
above. |
| 490 |
.TP |
| 491 |
.B -Y num |
| 492 |
Set the vertical resolution in dots per inch to |
| 493 |
.IR num . |
| 494 |
.TP |
| 495 |
.B -z |
| 496 |
Pass |
| 497 |
.B html |
| 498 |
hyperdvi specials through to the output for eventual |
| 499 |
distillation into PDF. This is not enabled by default to avoid |
| 500 |
including the header files unnecessarily, and use of temporary files in |
| 501 |
creating the output. |
| 502 |
.TP |
| 503 |
.B -Z |
| 504 |
Causes bitmapped fonts to be compressed before they are downloaded, |
| 505 |
thereby reducing the size of the PostScript font-downloading |
| 506 |
information. Especially useful at high resolutions or when very large |
| 507 |
fonts are used. Will slow down printing somewhat, especially on early |
| 508 |
68000-based PostScript printers. |
| 509 |
.SH "SEE ALSO" |
| 510 |
afm2tfm(1), tex(1), mf(1), dvitype(1), lpr(1), |
| 511 |
.IR dvips.texi , |
| 512 |
https://tug.org/dvips. |
| 513 |
.SH ENVIRONMENT |
| 514 |
Dvipsk uses the same environment variables and algorithms for finding |
| 515 |
font files as TeX and its friends do. See the documentation for the |
| 516 |
Kpathsea library for details. (Repeating it here is too cumbersome.) |
| 517 |
.PP |
| 518 |
KPATHSEA_DEBUG: Trace Kpathsea lookups; set to -1 for complete tracing. |
| 519 |
.PP |
| 520 |
PRINTER: see above. |
| 521 |
.SH NOTES |
| 522 |
PostScript is a registered trademark of Adobe Systems Incorporated. |
| 523 |
.SH AUTHOR |
| 524 |
Tomas Rokicki; extended to virtual fonts |
| 525 |
by Don Knuth. Path searching and configuration modifications by |
| 526 |
Karl Berry. |
| 527 |
.PP |
| 528 |
Maintained in TeX Live; please send bug reports or other correspondence |
| 529 |
to [email protected] (https://lists.tug.org/tex-k). |