summaryrefslogtreecommitdiff
path: root/Build/source/texk/dvipng/dvipng.1
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/texk/dvipng/dvipng.1')
-rw-r--r--Build/source/texk/dvipng/dvipng.151
1 files changed, 29 insertions, 22 deletions
diff --git a/Build/source/texk/dvipng/dvipng.1 b/Build/source/texk/dvipng/dvipng.1
index d0107a35785..7bc3889a947 100644
--- a/Build/source/texk/dvipng/dvipng.1
+++ b/Build/source/texk/dvipng/dvipng.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
+.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -48,22 +48,25 @@
. ds R" ''
'br\}
.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
-.if \nF \{\
+.ie \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. nr % 0
. rr F
.\}
-.\"
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes
-.\" way too many mistakes in technical documents.
-.hy 0
-.if n .na
+.el \{\
+. de IX
+..
+.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
@@ -129,7 +132,11 @@
.\" ========================================================================
.\"
.IX Title "DVIPNG 1"
-.TH DVIPNG 1 "2008-05-14" "dvipng 1.11" "User commands"
+.TH DVIPNG 1 "2009-02-23" "dvipng 1.12" "User commands"
+.\" For nroff, turn off justification. Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
.SH "NAME"
dvipng \- A DVI\-to\-PNG translator
.SH "SYNOPSIS"
@@ -140,7 +147,7 @@ dvipng [options] [filename] \-
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This program makes \s-1PNG\s0 and/or \s-1GIF\s0 graphics from \s-1DVI\s0 files as obtained
-from TeX and its relatives.
+from TeX and its relatives.
.PP
If \s-1GIF\s0 support is enabled, \s-1GIF\s0 output is chosen by using the
\&\fBdvigif\fR binary or with the \fB\-\-gif\fR option.
@@ -148,8 +155,8 @@ If \s-1GIF\s0 support is enabled, \s-1GIF\s0 output is chosen by using the
The benefits of \fBdvipng\fR/\fBdvigif\fR include
.IP "\(bu" 4
Speed. It is a very fast bitmap-rendering code for \s-1DVI\s0 files, which
-makes it suitable for generating large amounts of images on\-the\-fly,
-as needed in preview\-latex, WeBWorK and others.
+makes it suitable for generating large amounts of images on-the-fly,
+as needed in preview-latex, WeBWorK and others.
.IP "\(bu" 4
It does not read the postamble, so it can be started before TeX
finishes. There is a \fB\-\-follow\fR switch that makes dvipng wait at
@@ -161,7 +168,7 @@ through stdin, and all options are usable. It is even possible to change
the input file through this interface.
.IP "\(bu" 4
Supports \s-1PK\s0, \s-1VF\s0, PostScript Type1, and TrueType fonts, subfonts (i.e.,
-as used in CJK\-LaTeX), color specials, and inclusion of PostScript,
+as used in CJK-LaTeX), color specials, and inclusion of PostScript,
\&\s-1PNG\s0, \s-1JPEG\s0 or \s-1GIF\s0 images.
.IP "\(bu" 4
and more...
@@ -195,7 +202,7 @@ with the background color. Giving a \fIcolor_spec\fR will set the
fallback color, to be used in viewers that cannot handle transparency
(the default is the background color). The color spec should be in
TeX color \especial syntax, e.g., 'rgb 1.0 0.0 0.0'. Setting the
-fallback color makes the default border width 1 px.
+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
@@ -213,17 +220,17 @@ all-lowercase 'transparent' will give a simple fully transparent
background with non-transparent antialiased pixels. The latter would be
suitable for viewers who cannot cope with a true alpha channel. \s-1GIF\s0
images do not support full alpha transparency, so in case of \s-1GIF\s0 output,
-both variants will use the latter behaviour.
+both variants will use the latter behaviour.
.IP "\fB\-d\fR \fInum\fR" 4
.IX Item "-d num"
Set the debug flags, showing what dvipng (thinks it) is doing. This will
work unless dvipng has been compiled without the \f(CW\*(C`DEBUG\*(C'\fR option
(not recommended). Set the flags as you need them, use \fB\-d \-1\fR as
-the first option for maximum output.
+the first option for maximum output.
.IP "\fB\-D\fR \fInum\fR" 4
.IX Item "-D num"
Set the output resolution, both horizontal and vertical, to \fInum\fR
-dpi (dots per inch).
+dpi (dots per inch).
.Sp
One may want to adjust this to fit a certain text font size (e.g., on
a web page), and for a text font height of \fIfont_px\fR pixels (in
@@ -270,7 +277,7 @@ there is a foreground color \especial in the \s-1DVI\s0. The color spec should
be in TeX color \especial syntax, e.g., 'rgb 1.0 0.0 0.0'.
.IP "\fB\-\-follow*\fR" 4
.IX Item "--follow*"
-Wait for data at end\-of\-file. One of the benefits of dvipng is that it
+Wait for data at end-of-file. One of the benefits of dvipng is that it
does not read the postamble, so it can be started before TeX
finishes. This switch makes dvipng wait at end-of-file for further
output, unless it finds the \s-1POST\s0 marker that indicates the end of the
@@ -325,7 +332,7 @@ 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.
+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
@@ -345,10 +352,10 @@ as deletefile, to prevent possibly malicious PostScript programs from
having any effect.
.IP "\fB\-o\fR \fIname\fR" 4
.IX Item "-o name"
-Send output to the file \fIname\fR. A single occurrence of \fB%d\fR or
-\&\fB%01d\fR, ..., \fB%09d\fR will be exchanged for the physical
+Send output to the file \fIname\fR. A single occurrence of \fB\f(CB%d\fB\fR or
+\&\fB\f(CB%01d\fB\fR, ..., \fB\f(CB%09d\fB\fR will be exchanged for the physical
page number (this can be changed, see the \fB\-\-dvinum\fR switch). The
-default output filename is \fIfile\fR\fB%d.png\fR where the input \s-1DVI\s0
+default output filename is \fIfile\fR\fB\f(CB%d\fB.png\fR where the input \s-1DVI\s0
file was \fIfile\fR\fB.dvi\fR.
.IP "\fB\-O\fR \fIx\-offset\fR\fB,\fR\fIy\-offset\fR" 4
.IX Item "-O x-offset,y-offset"
@@ -356,7 +363,7 @@ Move the origin by \fIx\-offset\fR,\fIy\-offset\fR, a comma-separated
pair of dimensions such as \fB.1in,\-.3cm\fR.
The origin of the page is shifted from the default position
(of one inch down, one inch to the right from the upper left corner of
-the paper) by this amount.
+the paper) by this amount.
.IP "\fB\-p [=]\fR\fInum\fR" 4
.IX Item "-p [=]num"
The first page printed will be the first one numbered \fInum\fR. Default