[tex-k] dvips documentation changes
Paul Vojta
vojta@Math.Berkeley.EDU
Thu, 16 Jan 2003 23:05:08 -0800 (PST)
Folks:
I found that not all of the dvips command line options are documented,
even in dvips.texi. Here's a diff that brings things up to date.
Improvements welcome. (In particular, my explanation of -G is pretty lame.)
--Paul Vojta
---- cut here ----
diff -ur texk/dvipsk/dvips.1 /home/vojta/dvips/dvips.1
--- texk/dvipsk/dvips.1 2002-10-17 17:22:19.000000000 -0700
+++ /home/vojta/dvips/dvips.1 2003-01-15 19:43:14.000000000 -0800
@@ -149,6 +149,12 @@
is driving the printer directly instead of working through a spooler,
as is common on extremely small systems. NOTE! DO NOT USE THIS OPTION!
.TP
+.B -G
+Causes
+.B dvips
+to shift non-printing characters to higher-numbered positions.
+This may be useful sometimes.
+.TP
.B -h name
Prepend file
.I name
@@ -174,6 +180,13 @@
before running out of steam; these options can be used to automatically
split a book into ten-page sections, each to its own file.
.TP
+.B -j
+Download only needed characters from Type 1 fonts. This is the
+default in the current release. Some debugging flags trace this operation.
+You can also control partial downloading on a per-font basis, via the
+.B psfonts.map
+file.
+.TP
.B -k
Print crop marks. This option increases the paper size (which should be
specified, either with a paper size special or with the
@@ -211,6 +224,15 @@
.B -m
Specify manual feed for printer.
.TP
+.B -mode mode
+Use
+.I mode
+as the Metafont device name for path searching and font
+generation. This overrides any value from configuration files. With
+the default paths, explicitly specifying the mode also makes the program
+assume the fonts are in a subdirectory named
+.IR mode .
+.TP
.B -M
Turns off the automatic font generation facility. If any fonts are
missing, commands to generate the fonts are appended to the file
@@ -388,6 +410,21 @@
.I -O.
It overrides any paper size special in the dvi file.
.TP
+.B -u psmapfile
+Set
+.I psmapfile
+to be the file that dvips uses for looking up PostScript font aliases. If
+.I psmapfile
+begins with a
+.B +
+character, then the rest of the name is used as the name of the map file,
+and the map file is appended to the list of map files (instead of replacing
+the list). In either case, if
+.I psmapfile
+has no extension, then
+.B .map
+is added at the end.
+.TP
.B -U
Disable a PostScript virtual memory saving optimization that stores the
character metric information in the same string that is used to store
@@ -396,6 +433,11 @@
that results in `garbage' on the bottom of each character. Not
recommended unless you must drive this printer.
.TP
+.B -v
+Print the
+.B dvips
+version number and exit.
+.TP
.B -V
Download non-resident PostScript fonts as bitmaps. This requires use of
`gsftopk' or `pstopk' or some other such program(s) in order to generate
@@ -403,19 +445,40 @@
.BR dvips .
.TP
.B -x num
-Set the magnification ratio to
+Set the
+.I x
+magnification ratio to
+.IR num /1000.
+Overrides the magnification specified in the .dvi file. Must be
+between 10 and 100000. Instead of an integer,
.I num
-/1000. Overrides the magnification specified in the .dvi file. Must be
-between 10 and 100000.
+may be a real number for increased precision.
.TP
.B -X num
Set the horizontal resolution in dots per inch to
.I num.
.TP
+.B -y num
+Set the
+.I y
+magnification ratio to
+.IR num /1000.
+See
+.B -x
+above.
+.TP
.B -Y num
Set the vertical resolution in dots per inch to
.I num.
.TP
+.B -z
+Pass
+.B html
+hyperdvi specials through to the output for eventual
+distillation into PDF. This is not enabled by default to avoid
+including the header files unnecessarily, and use of temporary files in
+creating the output.
+.TP
.B -Z
Causes bitmapped fonts to be compressed before they are downloaded,
thereby reducing the size of the PostScript font-downloading
diff -ur texk/dvipsk/dvips.c /home/vojta/dvips/dvips.c
--- texk/dvipsk/dvips.c 2002-10-17 17:22:19.000000000 -0700
+++ /home/vojta/dvips/dvips.c 2003-01-15 19:11:25.000000000 -0800
@@ -272,6 +272,7 @@
"k* Print crop marks K* Pull comments from inclusions ",
"l # Last page ",
"m* Manual feed M* Don't make fonts ",
+"mode s Metafont device name ",
"n # Maximum number of pages N* No structured comments ",
"o f Output file O c Set/change paper offset ",
#if defined(MSDOS) || defined(OS2)
@@ -279,18 +280,24 @@
#else
"p # First page P s Load config.$s ",
#endif
+"pp l Print only pages listed ",
"q* Run quietly ",
"r* Reverse order of pages R* Run securely ",
"s* Enclose output in save/restore S # Max section size in pages ",
"t s Paper format T c Specify desired page size ",
"u s PS mapfile U* Disable string param trick ",
-" V* Send downloadable PS fonts as PK",
+"v Print version number and quit V* Send downloadable PS fonts as PK",
"x # Override dvi magnification X # Horizontal resolution ",
"y # Multiply by dvi magnification Y # Vertical resolution ",
+#ifdef HPS
"z* Hyper PS Z* Compress bitmap fonts ",
+#else
+" Z* Compress bitmap fonts ",
+#endif
/* "- Interactive query of options", */
" # = number f = file s = string * = suffix, `0' to turn off ",
-" c = comma-separated dimension pair (e.g., 3.2in,-32.1cm) ", 0} ;
+" c = comma-separated dimension pair (e.g., 3.2in,-32.1cm) ",
+" l = comma-separated list of page ranges (e.g., 1-4,7-9) ", 0} ;
void
help P1C(int, status)
diff -ur texk/dvipsk/dvips.help /home/vojta/dvips/dvips.help
--- texk/dvipsk/dvips.help 2002-10-12 16:33:36.000000000 -0700
+++ /home/vojta/dvips/dvips.help 2003-01-15 19:47:24.000000000 -0800
@@ -12,19 +12,22 @@
k* Print crop marks K* Pull comments from inclusions
l # Last page
m* Manual feed M* Don't make fonts
+mode s Metafont device name
n # Maximum number of pages N* No structured comments
o f Output file O c Set/change paper offset
p # First page P s Load config.$s
+pp l Print only pages listed
q* Run quietly
r* Reverse order of pages R* Run securely
s* Enclose output in save/restore S # Max section size in pages
t s Paper format T c Specify desired page size
u s PS mapfile U* Disable string param trick
- V* Send downloadable PS fonts as PK
+v Print version number and quit V* Send downloadable PS fonts as PK
x # Override dvi magnification X # Horizontal resolution
y # Multiply by dvi magnification Y # Vertical resolution
z* Hyper PS Z* Compress bitmap fonts
# = number f = file s = string * = suffix, `0' to turn off
c = comma-separated dimension pair (e.g., 3.2in,-32.1cm)
+ l = comma-separated list of page ranges (e.g., 1-4,7-9)
Email bug reports to tex-k@@mail.tug.org.
diff -ur texk/dvipsk/dvips.texi /home/vojta/dvips/dvips.texi
--- texk/dvipsk/dvips.texi 2002-10-17 17:22:19.000000000 -0700
+++ /home/vojta/dvips/dvips.texi 2003-01-15 19:24:30.000000000 -0800
@@ -778,6 +778,13 @@
systems. On systems shared by more than one person, this is not
recommended.
+@item -G*
+@opindex -G
+@cindex low characters, shifting
+@cindex non-printing characters, shifting
+Shift non-printing characters (ASCII 0-32, 127) to higher-numbered positions.
+This may be useful sometimes.
+
@item -h @var{name}
@opindex -h @var{name}
@cindex header file, downloading
@@ -1055,6 +1062,17 @@
of dimensions such as @samp{.1in,-.3cm} (@pxref{papersize special}). It
overrides any paper size special in the DVI file.
+@item -u @var{psmapfile}
+@opindex -u @var{psmapfile}
+@cindex PostScript font alias file
+@cindex resident fonts, different in different printers
+Set @var{psmapfile} to be the file that dvips uses for looking up
+PostScript font aliases. If @var{psmapfile} begins with a @samp{+}
+character, then the rest of the name is used as the name of the map file,
+and the map file is appended to the list of map files (instead of replacing
+the list). In either case, if the name has no extension, then @samp{.map}
+is added at the end.
+
@item -U*
@opindex -U
@cindex Xerox 4045
@@ -1065,6 +1083,10 @@
bottom of each character. Not recommended unless you must drive this
printer.
+@item -v
+@opindex -v
+Print the dvips version number and exit.
+
@item -V*
@opindex -V
Download non-resident PostScript fonts as bitmaps. This requires use