summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/dvipng
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-06-17 00:16:42 +0000
committerKarl Berry <karl@freefriends.org>2010-06-17 00:16:42 +0000
commit55133e0c2bb3ef821339a09c48fbcf3f0d2dde27 (patch)
tree2c1fd130535207fb2157e62516527b5d9171cf5b /Master/texmf/doc/dvipng
parent83f44dc7cbbf424407a091b932e3d8344911dbb5 (diff)
texinfo manual updates
git-svn-id: svn://tug.org/texlive/trunk@19010 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc/dvipng')
-rw-r--r--Master/texmf/doc/dvipng/dvipng.html86
-rw-r--r--Master/texmf/doc/dvipng/dvipng.pdfbin256860 -> 224620 bytes
2 files changed, 63 insertions, 23 deletions
diff --git a/Master/texmf/doc/dvipng/dvipng.html b/Master/texmf/doc/dvipng/dvipng.html
index b2de8e77039..692fffa865a 100644
--- a/Master/texmf/doc/dvipng/dvipng.html
+++ b/Master/texmf/doc/dvipng/dvipng.html
@@ -76,7 +76,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
<p>This manual documents dvipng, a program to translate a DVI (DeVice
Independent) file into PNG (Portable Network Graphics).
- <p>This file documents dvipng version 1.12
+ <p>This file documents dvipng version 1.13
<p>Corrections or perhaps rewrites of sections are <em>very welcome</em>.
@@ -449,7 +449,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Command_002dline-options">Command-line
<p><a name="index-options_002c-summary-7"></a>Here is a handy summary of the options; it is printed out when you run
dvipng with no arguments or with the standard &lsquo;<samp><span class="samp">--help</span></samp>&rsquo; option.
-<pre class="example"> This is ./dvipng 1.12 Copyright 2002-2008 Jan-Ake Larsson
+<pre class="example"> This is ./dvipng 1.13 Copyright 2002-2010 Jan-Ake Larsson
Usage: ./dvipng [OPTION]... FILENAME[.dvi]
Options are chosen to be similar to dvips' options where possible:
@@ -757,14 +757,17 @@ DVI, e.g., via a PostScript special (i.e., the &lsquo;<samp><span class="samp">g
<br><dt>&lsquo;<samp><span class="samp">-v*</span></samp>&rsquo;<dd>Enable verbose operation. This will currently indicate what fonts is
used, in addition to the usual output.
- <br><dt>&lsquo;<samp><span class="samp">-x </span><var>num</var></samp>&rsquo;<dd><a name="index-magnification_002c-overriding-DVI-60"></a>Set the x magnification ratio to <var>num</var>/1000. Overrides
+ <br><dt>&lsquo;<samp><span class="samp">--width*</span></samp>&rsquo;<dd><a name="index-width-reporting-60"></a>Report the width of the image. See also &lsquo;<samp><span class="samp">--height</span></samp>&rsquo; and
+&lsquo;<samp><span class="samp">--depth</span></samp>&rsquo;.
+
+ <br><dt>&lsquo;<samp><span class="samp">-x </span><var>num</var></samp>&rsquo;<dd><a name="index-magnification_002c-overriding-DVI-61"></a>Set the x magnification ratio to <var>num</var>/1000. Overrides
the magnification specified in the DVI 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 PK files generated. <var>num</var> may be a real number, not an
integer, for increased precision.
- <br><dt>&lsquo;<samp><span class="samp">-z </span><var>num</var></samp>&rsquo;<dd><a name="index-compression-61"></a>Set the PNG compression level to <var>num</var>. This option is enabled if
+ <br><dt>&lsquo;<samp><span class="samp">-z </span><var>num</var></samp>&rsquo;<dd><a name="index-compression-62"></a>Set the PNG compression level to <var>num</var>. This option is enabled if
your &lsquo;<samp><span class="samp">libgd</span></samp>&rsquo; is new enough. The default compression level is 1,
which selects maximum speed at the price of slightly larger PNGs. For an
older &lsquo;<samp><span class="samp">libgd</span></samp>&rsquo;, the hard-soldered value 5 is used. The include file
@@ -828,7 +831,7 @@ use the &lsquo;<samp><span class="samp">png16m</span></samp>&rsquo; device to pr
inclusion. Other relevant switches are &lsquo;<samp><span class="samp">--noghostscript</span></samp>&rsquo; and
&lsquo;<samp><span class="samp">--nogssafer</span></samp>&rsquo;. See <a href="#Option-details">Option details</a>.
- <p><a name="index-PostScript-inclusion-problems-62"></a>The most common problem with including graphics is an incorrect
+ <p><a name="index-PostScript-inclusion-problems-63"></a>The most common problem with including graphics is an incorrect
bounding box. Complain to whoever wrote the software that generated
the file if the bounding box is indeed incorrect. An adjusted
boundingbox can be specified in the &lsquo;<samp><span class="samp">\includegraphics</span></samp>&rsquo; call, as
@@ -900,7 +903,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Color">Color</a>
<h3 class="section">6.1 Color specifications</h3>
-<p><a name="index-color-specifications-63"></a>
+<p><a name="index-color-specifications-64"></a>
The color specification supported by dvipng is by-value or by-name. The
by-value spec starts with the name of a color model (one of &lsquo;<samp><span class="samp">rgb</span></samp>&rsquo;,
&lsquo;<samp><span class="samp">hsb</span></samp>&rsquo;, &lsquo;<samp><span class="samp">cmy</span></samp>&rsquo;, &lsquo;<samp><span class="samp">cmyk</span></samp>&rsquo;, or &lsquo;<samp><span class="samp">gray</span></samp>&rsquo;) followed by the
@@ -968,7 +971,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<h2 class="chapter">7 Diagnosing problems</h2>
-<p><a name="index-problems-64"></a><a name="index-trouble-65"></a><a name="index-debugging-66"></a>
+<p><a name="index-problems-65"></a><a name="index-trouble-66"></a><a name="index-debugging-67"></a>
You've gone through all the trouble of installing dvipng, carefully read
all the instructions in this manual, and still can't get something to
work. The following sections provide some helpful hints if you find
@@ -1062,14 +1065,50 @@ bugs and suggesting improvements as the thing has evolved. These
include but is perhaps not limited to (in semi-random order): Thomas
Esser (teTeX), Christian Schenk (MIKTeX), Brian R Furry (debian
package), Angus Leeming (LyX), Thomas Boutell (libgd), John Jones
-(first user report), Uwe Kern (xcolor), Karl Berry (TeX Live),
-David Harvey (hinting in Freetype), Neal Harmon, Alan Shutko, Reiner
-Stieb, Nick Alcock, Adam Buchbinder, Svend Tollak Munkejord, James
-Longstreet, Bernhard Simon, Bob McElrath, Georg Schwarz, Jason Farmer,
-Brian V. Smith, Samuel Hathaway, Thomas R. Shemanske, Stephen Gibson,
-Christian Ridderstr&ouml;m, Ezra Peisach, William H Wheeler, Thomas
-Klausner, Harald Koenig, Adrian Bunk, Kevin Smith, Jason Riedy,
-Wolfram Krause, Reinhard Kotucha, and Takeshi Abe.
+(first user report), Uwe Kern (xcolor), Karl Berry and Peter
+Breitenlohner (TeX Live), David Harvey (hinting in Freetype), Neal
+Harmon, Alan Shutko, Reiner Stieb, Nick Alcock, Adam Buchbinder, Svend
+Tollak Munkejord, James Longstreet, Bernhard Simon, Bob McElrath,
+Georg Schwarz, Jason Farmer, Brian V. Smith, Samuel Hathaway, Thomas
+R. Shemanske, Stephen Gibson, Christian Ridderstr&ouml;m, Ezra Peisach,
+William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin
+Smith, Jason Riedy, Wolfram Krause, Reinhard Kotucha, Takeshi Abe, and
+Waldeck Schutzer.
+
+ <p>Use of the <code>gd</code> library requires inclusion of the following
+copyright notice, which applies to the <code>gd</code> library:
+
+ <blockquote>
+Portions copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 by Cold Spring Harbor Laboratory. Funded under Grant P41-RR02188 by the National Institutes of Health.
+
+ <p>Portions copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 by Boutell.Com, Inc.
+
+ <p>Portions relating to GD2 format copyright 1999, 2000, 2001, 2002, 2003, 2004 Philip Warner.
+
+ <p>Portions relating to PNG copyright 1999, 2000, 2001, 2002, 2003, 2004 Greg Roelofs.
+
+ <p>Portions relating to gdttf.c copyright 1999, 2000, 2001, 2002, 2003, 2004 John Ellson (ellson@graphviz.org).
+
+ <p>Portions relating to gdft.c copyright 2001, 2002, 2003, 2004 John Ellson (ellson@graphviz.org).
+
+ <p>Portions relating to JPEG and to color quantization copyright 2000, 2001, 2002, 2003, 2004, Doug Becker and copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 Thomas G. Lane. This software is based in part on the work of the Independent JPEG Group. See the file README-JPEG.TXT for more information.
+
+ <p>Portions relating to GIF compression copyright 1989 by Jef Poskanzer and David Rowley, with modifications for thread safety by Thomas Boutell.
+
+ <p>Portions relating to GIF decompression copyright 1990, 1991, 1993 by David Koblas, with modifications for thread safety by Thomas Boutell.
+
+ <p>Portions relating to WBMP copyright 2000, 2001, 2002, 2003, 2004 Maurice Szmurlo and Johan Van den Brande.
+
+ <p>Portions relating to GIF animations copyright 2004 Jaakko Hyv&auml;dtti (jaakko.hyvatti@iki.fi)
+
+ <p>Permission has been granted to copy, distribute and modify gd in any context without fee, including a commercial application, provided that this notice is present in user-accessible supporting documentation.
+
+ <p>This does not affect your ownership of the derived work itself, and the intent is to assure proper credit for the authors of gd, not to interfere with your productive use of gd. If you have questions, ask. "Derived works" includes all programs that utilize the library. Credit must be given in user-accessible documentation.
+
+ <p>This software is provided "AS IS." The copyright holders disclaim all warranties, either express or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to this code and accompanying documentation.
+
+ <p>Although their code does not appear in the current release, the authors also wish to thank Hutchison Avenue Software Corporation for their prior contributions.
+</blockquote>
<div class="node">
<a name="Copying"></a>
@@ -1100,7 +1139,7 @@ License along with this program. If not, see
</pre>
-Copyright &copy; 2002-2008 Jan-&Aring;ke Larsson
+Copyright &copy; 2002-2010 Jan-&Aring;ke Larsson
<div class="node">
<a name="Index"></a>
@@ -1120,13 +1159,13 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-background-color-_0028option_0029-14">background color (option)</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-base-resolution_002c-setting-13">base resolution, setting</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-baseline-reporting-17">baseline reporting</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-color-specifications-63">color specifications</a>: <a href="#Color-specifications">Color specifications</a></li>
+<li><a href="#index-color-specifications-64">color specifications</a>: <a href="#Color-specifications">Color specifications</a></li>
<li><a href="#index-command_002dline-options-5">command-line options</a>: <a href="#Command_002dline-options">Command-line options</a></li>
<li><a href="#index-compilation-2">compilation</a>: <a href="#Installation">Installation</a></li>
-<li><a href="#index-compression-61">compression</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-compression-62">compression</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-configuration_002c-of-dvipng-1">configuration, of dvipng</a>: <a href="#Installation">Installation</a></li>
<li><a href="#index-dark-fonts-23">dark fonts</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-debugging-66">debugging</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
+<li><a href="#index-debugging-67">debugging</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
<li><a href="#index-debugging-15">debugging</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-depth-reporting-18">depth reporting</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-exit-on-erroneous-images-57">exit on erroneous images</a>: <a href="#Option-details">Option details</a></li>
@@ -1146,7 +1185,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-invoking-dvipng-4">invoking dvipng</a>: <a href="#Basic-usage">Basic usage</a></li>
<li><a href="#index-last-page-printed-29">last page printed</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-light-fonts-24">light fonts</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-magnification_002c-overriding-DVI-60">magnification, overriding DVI</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-magnification_002c-overriding-DVI-61">magnification, overriding DVI</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-Metafont-mode_002c-specifying-34">Metafont mode, specifying</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-mktexpk_0040r_007b_002c-avoiding_007d-36"><code>mktexpk</code><span class="roman">, avoiding</span></a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-mode-name_002c-specifying-33">mode name, specifying</a>: <a href="#Option-details">Option details</a></li>
@@ -1164,8 +1203,8 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-physical-page-number_002c-and-_0040samp_007b_002dl_007d-31">physical page number, and &lsquo;<samp><span class="samp">-l</span></samp>&rsquo;</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-physical-page-number_002c-and-_0040samp_007b_002dp_007d-45">physical page number, and &lsquo;<samp><span class="samp">-p</span></samp>&rsquo;</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-PNG-image-format-49">PNG image format</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-PostScript-inclusion-problems-62">PostScript inclusion problems</a>: <a href="#Encapsulated-PostScript">Encapsulated PostScript</a></li>
-<li><a href="#index-problems-64">problems</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
+<li><a href="#index-PostScript-inclusion-problems-63">PostScript inclusion problems</a>: <a href="#Encapsulated-PostScript">Encapsulated PostScript</a></li>
+<li><a href="#index-problems-65">problems</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
<li><a href="#index-quality-55">quality</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-quiet-operation-51">quiet operation</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-reverse-pagination-56">reverse pagination</a>: <a href="#Option-details">Option details</a></li>
@@ -1175,8 +1214,9 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
<li><a href="#index-T1lib-font-rendering-58">T1lib font rendering</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-transparent-border-fallback-color-12">transparent border fallback color</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-transparent-border-width-11">transparent border width</a>: <a href="#Option-details">Option details</a></li>
-<li><a href="#index-trouble-65">trouble</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
+<li><a href="#index-trouble-66">trouble</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li>
<li><a href="#index-truecolor-output-59">truecolor output</a>: <a href="#Option-details">Option details</a></li>
<li><a href="#index-warnings_002c-suppressing-53">warnings, suppressing</a>: <a href="#Option-details">Option details</a></li>
+<li><a href="#index-width-reporting-60">width reporting</a>: <a href="#Option-details">Option details</a></li>
</ul></body></html>
diff --git a/Master/texmf/doc/dvipng/dvipng.pdf b/Master/texmf/doc/dvipng/dvipng.pdf
index e92a19ce5be..0db65ef0fa6 100644
--- a/Master/texmf/doc/dvipng/dvipng.pdf
+++ b/Master/texmf/doc/dvipng/dvipng.pdf
Binary files differ