summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/dvips.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/dvips.1')
-rw-r--r--Master/texmf/doc/man/man1/dvips.154
1 files changed, 31 insertions, 23 deletions
diff --git a/Master/texmf/doc/man/man1/dvips.1 b/Master/texmf/doc/man/man1/dvips.1
index 09170168cd8..05e5bcb5d2b 100644
--- a/Master/texmf/doc/man/man1/dvips.1
+++ b/Master/texmf/doc/man/man1/dvips.1
@@ -1,11 +1,9 @@
-.TH DVIPS 1 "27 May 2004"
+.TH DVIPS 1 "4 May 2010"
.SH NAME
dvips \- convert a TeX DVI file to PostScript
.SH SYNOPSIS
.B dvips
-[
-.I options
-]
+.RI [ OPTIONS ]
.IR file [\fB.dvi\fP]
.SH DESCRIPTION
THIS MAN PAGE IS OBSOLETE!
@@ -13,7 +11,7 @@ See the Texinfo documentation instead.
You can read it either in Emacs or with the standalone
.B info
program which comes with the GNU texinfo distribution as
-prep.ai.mit.edu:pub/gnu/texinfo*.tar.gz.
+ftp.gnu.org:pub/gnu/texinfo/texinfo*.tar.gz.
.PP
The program
.B dvips
@@ -78,14 +76,8 @@ Set the debug flags. This is intended only for emergencies or for
unusual fact-finding expeditions; it will work only if
.B dvips
has been compiled with the DEBUG option. If nonzero, prints additional
-information on standard error. The number is taken as a set of
-independent bits. The meaning of each bit follows. 1=specials;
-2=paths; 4=fonts; 8=pages; 16=headers; 32=font compression; 64=files;
-128=memory; 256=Kpathsea stat(2) calls; 512=Kpathsea hash table lookups;
-1024=Kpathsea path element expansion; 2048=Kpathsea searches. To trace
-everything having to do with file searching and opening, use 3650 (2048
-+ 1024 + 512 + 64 + 2). To track all classes, you can use `-1' (output
-is extremely voluminous).
+information on standard error. For maximum information, you can use
+`-1'. See the Dvips Texinfo manual for more details.
.TP
.B -D num
Set the resolution in dpi (dots per inch) to
@@ -251,18 +243,33 @@ that try to interpret PostScript comments in weird ways, or on some
PostScript printers. Old versions of TranScript in particular cannot
handle modern Encapsulated PostScript.
.TP
-.B -noomega
-This will disable the use of Omega extensions when interpreting DVI files.
-By default, the additional opcodes
+.BR -noomega
+This will disable the use of Omega and pTeX extensions when interpreting DVI
+files. By default, the additional opcodes
.I 129
and
.I 134
are recognized by dvips as Omega extensions and interpreted as requests to
-set 2-byte characters. The only drawback is that the virtual font array will
-(at least temporarily) require 65536 positions instead of the default 256
-positions, i.e. the memory requirements of dvips will be slightly larger. If
-you find this unacceptable or encounter another problem with the Omega
-extensions, you can switch this extension off by using
+set 2-byte characters.
+.TP
+.BR -noptex
+This will disable the use of pTeX extensions when interpreting DVI files.
+By default, the additional opcodes
+.I 130
+and
+.I 135
+are recognized by dvips as pTeX extensions and interpreted as requests to
+set 3-byte characters, and
+.I 255
+as request to change the typesetting direction.
+.sp
+The only drawback is that the virtual font array will (at least temporarily)
+require 65536 or more positions instead of the default 256 positions, i.e.,
+the memory requirements of dvips will be somewhat larger. If you find this
+unacceptable or encounter another problem with the Omega or pTeX extensions,
+you can switch off the pTeX extension by using
+.BR -noptex ,
+or both by using
.B -noomega
(but please do send a bug report if you find such problems - see the bug
address in the
@@ -506,7 +513,8 @@ fonts are used. Will slow down printing somewhat, especially on early
68000-based PostScript printers.
.SH "SEE ALSO"
mf(1), afm2tfm(1), tex(1), latex(1), lpr(1),
-.IR dvips.texi .
+.IR dvips.texi ,
+http://tug.org/dvips.
.SH ENVIRONMENT
Dvipsk uses the same environment variables and algorithms for finding
font files as TeX and its friends do. See the documentation for the
@@ -520,4 +528,4 @@ PostScript is a registered trademark of Adobe Systems Incorporated.
.SH AUTHOR
Tomas Rokicki <rokicki@cs.stanford.edu>; extended to virtual fonts
by Don Knuth. Path searching and configuration modifications by
-kb@mail.tug.org.
+Karl Berry.