dvipng 1.14 manpage

git-svn-id: svn://tug.org/texlive/trunk@20754 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 60 insertions, 51 deletions

diff --git a/Build/source/texk/dvipng/doc/dvipng.1 b/Build/source/texk/dvipng/doc/dvipng.1
index 228ba202046..934a7c9aac5 100644
--- a/Build/source/texk/dvipng/doc/dvipng.1
+++ b/Build/source/texk/dvipng/doc/dvipng.1
@@ -132,7 +132,7 @@
 .\" ========================================================================
 .\"
 .IX Title "DVIPNG 1"
-.TH DVIPNG 1 "2010-05-07" "dvipng 1.13" "User commands"
+.TH DVIPNG 1 "2010-12-15" "dvipng 1.14" "User commands"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -205,9 +205,11 @@ TeX color \especial syntax, e.g., 'rgb 1.0 0.0 0.0'. Setting the
 fallback color makes the default border width 1 px.
 .IP "\fB\-\-bdpi\fR \fInum\fR" 4
 .IX Item "--bdpi num"
-Set the base (Metafont) resolution, both horizontal and vertical, to
-\&\fInum\fR dpi (dots per inch). This option is necessary when manually
-selecting Metafont mode with the \-\-mode option (see below).
+This option only has an effect when using bitmapped (\s-1PK\s0) fonts. The
+option sets the base (Metafont) resolution, both horizontal and
+vertical, to \fInum\fR dpi (dots per inch). This option is necessary
+when manually selecting Metafont mode with the \-\-mode option (see
+below).
 .IP "\fB\-bg\fR \fIcolor_spec\fR" 4
 .IX Item "-bg color_spec"
 Choose background color for the images. This option will be ignored if
@@ -289,12 +291,12 @@ available if the FreeType2 font library was present at compilation time.
 If this is the case, dvipng will have direct support for PostScript
 Type1 and TrueType fonts internally, rather than using \fBgsftopk\fR
 for rendering the fonts. If you have PostScript versions of Computer
-Modern installed, there will be no need to generate bitmapped variants
-on disk of these. Then, you can render images at different (and unusual)
-resolutions without cluttering the disk with lots of bitmapped fonts.
-Note that if you have both FreeType and T1lib on your system, FreeType
-will be preferred by dvipng. If you for some reason would want to use
-T1lib rendering, use this option.
+Modern installed, there will be no need to generate bitmapped (\s-1PK\s0)
+variants on disk of these. Then, you can render images at different (and
+unusual) resolutions without cluttering the disk with lots of bitmapped
+fonts.  Note that if you have both FreeType and T1lib on your system,
+FreeType will be preferred by dvipng. If you for some reason would want
+to use T1lib rendering, use this option.
 .IP "\fB\-\-gamma\fR \fInum\fR" 4
 .IX Item "--gamma num"
 Control the interpolation of colors in the greyscale anti-aliasing
@@ -328,20 +330,20 @@ Thus, using \fB\-l =9\fR will end with the ninth page of the document,
 no matter what the pages are actually numbered.
 .IP "\fB\-\-mode\fR \fImode\fR" 4
 .IX Item "--mode mode"
-Use \fImode\fR as the Metafont device name for the \s-1PK\s0 fonts (both for
-path searching and font generation). This needs to be augmented with the
-base device resolution, given with the \fB\-\-bdpi\fR option. See the
-file <\fBftp://ftp.tug.org/tex/modes.mf\fR> for a list of resolutions and
-mode names for most devices.
+This option only has an effect when using bitmapped (\s-1PK\s0) fonts. Use
+\&\fImode\fR as the Metafont device name for the \s-1PK\s0 fonts (both for path
+searching and font generation). This needs to be augmented with the base
+device resolution, given with the \fB\-\-bdpi\fR option. See the file
+<\fBftp://ftp.tug.org/tex/modes.mf\fR> for a list of resolutions and mode
+names for most devices.
 .IP "\fB\-M*\fR" 4
 .IX Item "-M*"
-Turns off automatic \s-1PK\s0 font generation (\fImktexpk\fR). This will have
-no effect when using PostScript fonts, since no \s-1PK\s0 font generation will
-be done anyway.
-.IP "\fB\-\-noghostscript*\fR" 4
-.IX Item "--noghostscript*"
+This option only has an effect when using bitmapped (\s-1PK\s0) fonts. It turns
+off automatic \s-1PK\s0 font generation (\fImktexpk\fR).
+.IP "\fB\-\-nogs*\fR" 4
+.IX Item "--nogs*"
 This switch prohibits the internal call to GhostScript for displaying
-PostScript specials. \fB\-\-noghostscript0\fR turns the call back on.
+PostScript specials. \fB\-\-nogs0\fR turns the call back on.
 .IP "\fB\-\-nogssafer*\fR" 4
 .IX Item "--nogssafer*"
 Normally, if GhostScript is used to render PostScript specials, the
@@ -350,6 +352,12 @@ GhostScript interpreter is run with the option \fB\-dSAFER\fR. The
 \&\fB\-dSAFER\fR option in Ghostscript disables PostScript operators such
 as deletefile, to prevent possibly malicious PostScript programs from
 having any effect.
+.IP "\fB\-\-norawps*\fR" 4
+.IX Item "--norawps*"
+Some packages generate raw PostScript specials, even non-rendering such
+specials.  This switch turns off the internal call to GhostScript
+intended to display these raw PostScript specials. \fB\-\-norawps0\fR
+turns the call back on.
 .IP "\fB\-o\fR \fIname\fR" 4
 .IX Item "-o name"
 Send output to the file \fIname\fR. A single occurrence of \fB\f(CB%d\fB\fR or
@@ -375,14 +383,13 @@ a value to compare with the TeX \fB\ecount0\fR values stored in the
 the document, no matter what the pages are actually numbered.
 .IP "\fB\-\-palette*\fR" 4
 .IX Item "--palette*"
-Starting from \fBdvipng\fR 1.8, the output \s-1PNG\s0 will be a truecolor
-png when an external image is included, to avoid unnecessary delay and
-quality reduction, and enable the \s-1EPS\s0 translator to draw on a
-transparent background and outside of the boundingbox. This switch
-will force palette (256\-color) output and make \fBdvipng\fR revert to
-the old behaviour, where included images were opaque and always
-clipped to the boundingbox. This will also override the
-\&\fB\-\-truecolor\fR switch if present.
+When an external image is included, \fBdvipng\fR will automatically
+switch to truecolor mode, to avoid unnecessary delay and quality
+reduction, and enable the \s-1EPS\s0 translator to draw on a transparent
+background and outside of the boundingbox. This switch will force
+palette (256\-color) output and make \fBdvipng\fR revert to opaque
+clipped image inclusion. This will also override the \fB\-\-truecolor\fR
+switch if present.
 .IP "\fB\-\-picky*\fR" 4
 .IX Item "--picky*"
 No images are output when a warning occurs. Normally, dvipng will
@@ -422,10 +429,10 @@ output; report no warnings (only errors) to standard error.
 .IP "\fB\-Q\fR \fInum\fR" 4
 .IX Item "-Q num"
 Set the quality to \fInum\fR. That is, choose the number of antialiasing
-levels for \s-1PK\s0 and T1lib rendering to be \fInum\fR*\fInum\fR+1. The default
-value is 4 which gives 17 levels of antialiasing for antialiased fonts
-from these two. If FreeType is available, its rendering is unaffected by
-this option.
+levels for bitmapped fonts (\s-1PK\s0) and fonts rendered using T1lib, to be
+\&\fInum\fR*\fInum\fR+1. The default value is 4 which gives 17 levels of
+antialiasing for antialiased fonts from these two. If FreeType is
+available, its rendering is unaffected by this option.
 .IP "\fB\-r*\fR" 4
 .IX Item "-r*"
 Toggle output of pages in reverse/forward order. By default, the first
@@ -449,17 +456,17 @@ the left in the produced image. The value \fBtight\fR will make dvipng
 only include all ink put on the page, producing neat images.
 .IP "\fB\-\-t1lib*\fR" 4
 .IX Item "--t1lib*"
-Enable/disable T1lib font rendering (default on). This option is
-available if the T1lib font library was present at compilation time. If
-this is the case, dvipng will have direct support for PostScript Type1
-fonts internally, rather than using \fBgsftopk\fR for rendering the
-fonts. If you have PostScript versions of Computer Modern installed,
-there will be no need to generate bitmapped variants on disk of these.
-Then, you can render images at different (and unusual) resolutions
-without cluttering the disk with lots of bitmapped fonts. Note that if
-you have both FreeType and T1lib on your system FreeType will be
-preferred by dvipng, and if you for some reason rather want to use
-T1lib, give the option \fB\-\-freetype0\fR (see above).
+Enable T1lib font rendering (default on). This option is available if
+the T1lib font library was present at compilation time. If this is the
+case, dvipng will have direct support for PostScript Type1 fonts
+internally, rather than using \fBgsftopk\fR for rendering the fonts. If
+you have PostScript versions of Computer Modern installed, there will be
+no need to generate bitmapped variants on disk of these.  Then, you can
+render images at different (and unusual) resolutions without cluttering
+the disk with lots of bitmapped fonts. Note that if you have both
+FreeType and T1lib on your system, FreeType will be preferred by dvipng,
+and if you for some reason rather want to use T1lib, give the option
+\&\fB\-\-freetype0\fR (see above).
 .IP "\fB\-\-truecolor*\fR" 4
 .IX Item "--truecolor*"
 This will make \fBdvipng\fR generate truecolor output. Note that
@@ -477,12 +484,14 @@ Report the width of the image. See also \fB\-\-height\fR and
 \&\fB\-\-depth\fR.
 .IP "\fB\-x\fR \fInum\fR" 4
 .IX Item "-x num"
-Set the x magnification ratio to \fInum\fR/1000. Overrides
-the magnification specified in the \s-1DVI\s0 file.  Must be between 10 and
-100000.  It is recommended that you use standard magstep values (1095,
-1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the total
-number of \s-1PK\s0 files generated.  \fInum\fR may be a real number, not an
-integer, for increased precision.
+This option is deprecated; it should not be used. It is much better to
+select the output resolution directly with the \fB\-D\fR option. This
+option sets the magnification ratio to \fInum\fR/1000 and
+overrides the magnification specified in the \s-1DVI\s0 file.  Must be between
+10 and 100000.  It is recommended that you use standard magstep values
+(1095, 1200, 1440, 1728, 2074, 2488, 2986, and so on) to help reduce the
+total number of \s-1PK\s0 files generated.  \fInum\fR may be a real number, not
+an integer, for increased precision.
 .IP "\fB\-z\fR \fInum\fR" 4
 .IX Item "-z num"
 Set the \s-1PNG\s0 compression level to \fInum\fR. This option is enabled if
@@ -498,7 +507,7 @@ considerably fewer calculations. In the future, these values may not
 correspond directly to the zlib compression levels.\*(R"
 .SH "NOTES"
 .IX Header "NOTES"
-The full manual is accessible in the info format, on most systems by typing
+The full manual is accessible in info format, on most systems by typing
 .PP
 .Vb 1
 \&        info dvipng