diff options
| -rw-r--r-- | Build/source/texk/kpathsea/kpathsea.info | 171 | ||||
| -rw-r--r-- | Build/source/texk/web2c/doc/web2c.info | 173 | ||||
| -rw-r--r-- | Master/texmf/doc/dvipng/dvipng.html | 514 | ||||
| -rw-r--r-- | Master/texmf/doc/dvips/dvips.html | 325 | ||||
| -rw-r--r-- | Master/texmf/doc/dvips/dvips.pdf | bin | 414758 -> 352277 bytes | |||
| -rw-r--r-- | Master/texmf/doc/info/dvipng.info | 555 | ||||
| -rw-r--r-- | Master/texmf/doc/info/dvips.info | 337 | ||||
| -rw-r--r-- | Master/texmf/doc/info/kpathsea.info | 171 | ||||
| -rw-r--r-- | Master/texmf/doc/info/web2c.info | 173 | ||||
| -rw-r--r-- | Master/texmf/doc/kpathsea/kpathsea.html | 11 | ||||
| -rw-r--r-- | Master/texmf/doc/kpathsea/kpathsea.pdf | bin | 561796 -> 548689 bytes | |||
| -rw-r--r-- | Master/texmf/doc/web2c/web2c.html | 26 | ||||
| -rw-r--r-- | Master/texmf/doc/web2c/web2c.pdf | bin | 611353 -> 596222 bytes |
13 files changed, 1348 insertions, 1108 deletions
diff --git a/Build/source/texk/kpathsea/kpathsea.info b/Build/source/texk/kpathsea/kpathsea.info index 3719f12a44f..11b984ebd45 100644 --- a/Build/source/texk/kpathsea/kpathsea.info +++ b/Build/source/texk/kpathsea/kpathsea.info @@ -14,7 +14,8 @@ END-INFO-DIR-ENTRY This file documents the Kpathsea library for path searching. - Copyright (C) 1993-2005 Karl Berry & Olaf Weber. + Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, +2005, 2007 Karl Berry & Olaf Weber. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -37,8 +38,8 @@ Kpathsea library **************** This manual documents how to install and use the Kpathsea library for -filename lookup. It corresponds to version 3.5.5, released in -June 2005. +filename lookup. It corresponds to version 3.5.6, released in +January 2007. * Menu: @@ -58,8 +59,8 @@ File: kpathsea.info, Node: Introduction, Next: Installation, Prev: Top, Up: 1 Introduction ************** -This manual corresponds to version 3.5.5 of the Kpathsea library, -released in June 2005. +This manual corresponds to version 3.5.6 of the Kpathsea library, +released in January 2007. The library's fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do @@ -4563,85 +4564,85 @@ Index Tag Table: -Node: Top1413 -Node: Introduction2056 -Node: History4032 -Node: Installation8124 -Node: Simple installation8914 -Node: Custom installation12497 -Node: Disk space13671 -Node: Kpathsea application distributions14555 -Node: Changing search paths15670 -Node: Default path features16852 -Node: Default path generation18988 -Node: Running configure20431 -Node: configure shells21482 -Node: configure options22534 -Node: configure environment24041 -Node: configure scenarios25843 -Node: Shared library27429 -Node: Running make28763 -Node: Installing files30810 -Node: Cleaning up32757 -Node: Filename database generation33805 -Node: mktex scripts34372 -Node: mktex configuration35329 -Node: mktex script names40873 -Node: mktex script arguments41971 -Node: Installation testing42861 -Node: Security43225 -Node: TeX directory structure45792 -Node: unixtex.ftp50214 -Node: Electronic distribution52229 -Node: CD-ROM distribution54994 -Node: Other TeX packages55964 -Node: Reporting bugs57260 -Node: Bug checklist58000 -Node: Mailing lists62101 -Node: Debugging63460 -Node: Logging68532 -Node: Common problems70043 -Node: Unable to find files70874 -Node: Slow path searching73285 -Node: Unable to generate fonts74662 -Node: TeX or Metafont failing77171 -Node: Empty Makefiles79049 -Node: XtStrings80279 -Node: dlopen81115 -Node: ShellWidgetClass81933 -Node: Pointer combination warnings83565 -Node: Path searching83954 -Node: Searching overview84601 -Node: Path sources87973 -Node: Config files89044 -Node: Path expansion92444 -Node: Default expansion93393 -Node: Variable expansion95463 -Node: Tilde expansion96866 -Node: Brace expansion97764 -Node: KPSE_DOT expansion98869 -Node: Subdirectory expansion99382 -Node: Filename database101731 -Node: ls-R103045 -Node: Filename aliases105939 -Node: Database format107117 -Node: Invoking kpsewhich108130 -Node: Path searching options109007 -Node: Auxiliary tasks113144 -Node: Standard options114652 -Node: TeX support114972 -Node: Supported file formats116263 -Node: File lookup123411 -Node: Glyph lookup124702 -Node: Basic glyph lookup125829 -Node: Fontmap126708 -Node: Fallback font129325 -Node: Suppressing warnings130290 -Node: Programming131395 -Node: Programming overview131908 -Node: Calling sequence134184 -Node: Program-specific files139213 -Node: Programming with config files140251 -Node: Index141551 +Node: Top1468 +Node: Introduction2114 +Node: History4093 +Node: Installation8185 +Node: Simple installation8975 +Node: Custom installation12558 +Node: Disk space13732 +Node: Kpathsea application distributions14616 +Node: Changing search paths15731 +Node: Default path features16913 +Node: Default path generation19049 +Node: Running configure20492 +Node: configure shells21543 +Node: configure options22595 +Node: configure environment24102 +Node: configure scenarios25904 +Node: Shared library27490 +Node: Running make28824 +Node: Installing files30871 +Node: Cleaning up32818 +Node: Filename database generation33866 +Node: mktex scripts34433 +Node: mktex configuration35390 +Node: mktex script names40934 +Node: mktex script arguments42032 +Node: Installation testing42922 +Node: Security43286 +Node: TeX directory structure45853 +Node: unixtex.ftp50275 +Node: Electronic distribution52290 +Node: CD-ROM distribution55055 +Node: Other TeX packages56025 +Node: Reporting bugs57321 +Node: Bug checklist58061 +Node: Mailing lists62162 +Node: Debugging63521 +Node: Logging68593 +Node: Common problems70104 +Node: Unable to find files70935 +Node: Slow path searching73346 +Node: Unable to generate fonts74723 +Node: TeX or Metafont failing77232 +Node: Empty Makefiles79110 +Node: XtStrings80340 +Node: dlopen81176 +Node: ShellWidgetClass81994 +Node: Pointer combination warnings83626 +Node: Path searching84015 +Node: Searching overview84662 +Node: Path sources88034 +Node: Config files89105 +Node: Path expansion92505 +Node: Default expansion93454 +Node: Variable expansion95524 +Node: Tilde expansion96927 +Node: Brace expansion97825 +Node: KPSE_DOT expansion98930 +Node: Subdirectory expansion99443 +Node: Filename database101792 +Node: ls-R103106 +Node: Filename aliases106000 +Node: Database format107178 +Node: Invoking kpsewhich108191 +Node: Path searching options109068 +Node: Auxiliary tasks113205 +Node: Standard options114713 +Node: TeX support115033 +Node: Supported file formats116324 +Node: File lookup123472 +Node: Glyph lookup124763 +Node: Basic glyph lookup125890 +Node: Fontmap126769 +Node: Fallback font129386 +Node: Suppressing warnings130351 +Node: Programming131456 +Node: Programming overview131969 +Node: Calling sequence134245 +Node: Program-specific files139274 +Node: Programming with config files140312 +Node: Index141612 End Tag Table diff --git a/Build/source/texk/web2c/doc/web2c.info b/Build/source/texk/web2c/doc/web2c.info index 2742d1abb9d..813482e96b5 100644 --- a/Build/source/texk/web2c/doc/web2c.info +++ b/Build/source/texk/web2c/doc/web2c.info @@ -34,8 +34,8 @@ END-INFO-DIR-ENTRY This file documents the installation and use of the programs in Web2c, an implementation of Donald Knuth's TeX system. - Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 -Karl Berry & Olaf Weber. + Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, +2005, 2007 Karl Berry & Olaf Weber. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -59,7 +59,7 @@ Web2c This document describes how to install and use the programs in the Web2c implementation of the TeX system, especially for Unix systems. It -corresponds to Web2c version 7.5.5, released in June 2005. +corresponds to Web2c version 7.5.6, released in January 2007. * Menu: @@ -83,8 +83,8 @@ File: web2c.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top 1 Introduction ************** -This manual corresponds to version 7.5.5 of Web2c, released in -June 2005. +This manual corresponds to version 7.5.6 of Web2c, released in +January 2007. "Web2c" is the name of a TeX implementation, originally for Unix, but now also running under DOS, Amiga, and other operating systems. By @@ -2216,9 +2216,11 @@ environment variables. Here is a list: Likewise, for Troff; default is `dmp'. `TEX' - The command run to typeset the labels in TeX; default is `tex'. - If you use LaTeX, set this to `latex', and supply an appropriate - `verbatimtex' header in the MP source (*note mpost invocation::). + The command run to typeset the labels in TeX; the default is + `etex', set in `texmf.cnf'. If you use LaTeX, set this to + `latex', and supply an appropriate `verbatimtex' header in the MP + source (*note mpost invocation::). Or put `%&latex' as the first + line of your LaTeX source. `TROFF' Likewise, for Troff; default is `'eqn -d\$\$ | troff -Tpost''. You @@ -2230,6 +2232,13 @@ environment variables. Here is a list: environment variable or configuration value to point to the appropriate font directory, traditionally `/usr/lib/font/devTERM'. + One more complication is whether the troff programs have a `g' + prefix. On Windows, TeX Live supports both ways: `makempx.exe' is + built to use `gsoelim.exe', `geqn.exe', and `gtroff.exe', while + `makempx-without-g-prefix.exe' is built to use `soelim.exe', + `eqn.exe', and `troff.exe'. MetaPost users on Windows using troff + for their labels should arrange to run the proper binary. + File: web2c.info, Node: dvitomp invocation, Next: dmp invocation, Prev: makempx invocation, Up: MetaPost @@ -4569,7 +4578,7 @@ Index * trip test: Triptrap. (line 6) * tripman.tex: Triptrap. (line 6) * triptrap Make target: Additional targets. (line 41) -* TROFF: makempx invocation. (line 79) +* TROFF: makempx invocation. (line 81) * Troff, and MetaPost: mpost invocation. (line 73) * Troff, WEB for: WEB. (line 14) * Trojan horses and TeX programs: tex invocation. (line 51) @@ -4662,78 +4671,78 @@ Index Tag Table: -Node: Top2967 -Node: Introduction3962 -Node: Installation7139 -Node: configure options9303 -Node: Compile-time options11385 -Node: Additional targets12511 -Node: Triptrap13792 -Node: Runtime options15321 -Node: Commonalities17093 -Node: Option conventions17698 -Node: Common options18922 -Node: Path searching23434 -Node: Output file location24456 -Node: Three programs25496 -Node: Initial and virgin26255 -Node: Memory dumps27355 -Node: Creating memory dumps27822 -Node: Determining the memory dump to use29083 -Node: Hardware and memory dumps30707 -Node: Editor invocation33176 -Node: \input filenames33906 -Node: TeX36899 -Node: tex invocation37989 -Node: Initial TeX45921 -Node: Formats47410 -Node: Languages and hyphenation50349 -Node: MLTeX50777 -Node: \charsubdef52272 -Node: \tracingcharsubdef54598 -Node: TCX files55173 -Node: patgen invocation60597 -Node: IPC and TeX61314 -Node: TeX extensions61915 -Node: Metafont63216 -Node: mf invocation64504 -Node: Initial Metafont68387 -Node: Modes70140 -Node: Online Metafont graphics72395 -Node: gftodvi invocation75668 -Node: mft invocation77927 -Node: MetaPost81982 -Node: mpost invocation83003 -Node: Initial MetaPost88188 -Node: makempx invocation90000 -Node: dvitomp invocation93500 -Node: dmp invocation94129 -Node: mpto invocation98150 -Node: newer invocation99132 -Node: BibTeX100069 -Node: bibtex invocation100430 -Node: Basic BibTeX style files102755 -Node: WEB104097 -Node: tangle invocation105380 -Node: weave invocation107503 -Node: pooltype invocation108911 -Node: DVI utilities110041 -Node: dvicopy invocation110985 -Node: dvitype invocation112283 -Node: dvitype output example114638 -Node: Font utilities117689 -Node: Font file formats118869 -Node: gftopk invocation122168 -Node: pktogf invocation123372 -Node: pktype invocation124551 -Node: gftype invocation127386 -Node: tftopl invocation131902 -Node: pltotf invocation136536 -Node: vftovp invocation137601 -Node: vptovf invocation139885 -Node: Font utilities available elsewhere140939 -Node: Legalisms143359 -Node: References145530 -Node: Index149915 +Node: Top2979 +Node: Introduction3977 +Node: Installation7157 +Node: configure options9321 +Node: Compile-time options11403 +Node: Additional targets12529 +Node: Triptrap13810 +Node: Runtime options15339 +Node: Commonalities17111 +Node: Option conventions17716 +Node: Common options18940 +Node: Path searching23452 +Node: Output file location24474 +Node: Three programs25514 +Node: Initial and virgin26273 +Node: Memory dumps27373 +Node: Creating memory dumps27840 +Node: Determining the memory dump to use29101 +Node: Hardware and memory dumps30725 +Node: Editor invocation33194 +Node: \input filenames33924 +Node: TeX36917 +Node: tex invocation38007 +Node: Initial TeX45939 +Node: Formats47428 +Node: Languages and hyphenation50367 +Node: MLTeX50795 +Node: \charsubdef52290 +Node: \tracingcharsubdef54616 +Node: TCX files55191 +Node: patgen invocation60615 +Node: IPC and TeX61332 +Node: TeX extensions61933 +Node: Metafont63234 +Node: mf invocation64522 +Node: Initial Metafont68405 +Node: Modes70158 +Node: Online Metafont graphics72413 +Node: gftodvi invocation75686 +Node: mft invocation77945 +Node: MetaPost82000 +Node: mpost invocation83021 +Node: Initial MetaPost88206 +Node: makempx invocation90018 +Node: dvitomp invocation94023 +Node: dmp invocation94652 +Node: mpto invocation98673 +Node: newer invocation99655 +Node: BibTeX100592 +Node: bibtex invocation100953 +Node: Basic BibTeX style files103278 +Node: WEB104620 +Node: tangle invocation105903 +Node: weave invocation108026 +Node: pooltype invocation109434 +Node: DVI utilities110564 +Node: dvicopy invocation111508 +Node: dvitype invocation112806 +Node: dvitype output example115161 +Node: Font utilities118212 +Node: Font file formats119392 +Node: gftopk invocation122691 +Node: pktogf invocation123895 +Node: pktype invocation125074 +Node: gftype invocation127909 +Node: tftopl invocation132425 +Node: pltotf invocation137059 +Node: vftovp invocation138124 +Node: vptovf invocation140408 +Node: Font utilities available elsewhere141462 +Node: Legalisms143882 +Node: References146053 +Node: Index150438 End Tag Table diff --git a/Master/texmf/doc/dvipng/dvipng.html b/Master/texmf/doc/dvipng/dvipng.html index 47f94e695be..3d2347dcc94 100644 --- a/Master/texmf/doc/dvipng/dvipng.html +++ b/Master/texmf/doc/dvipng/dvipng.html @@ -40,18 +40,23 @@ <li><a href="#Option-summary">4.1 Option summary</a> <li><a href="#Option-details">4.2 Option details</a> </li></ul> -<li><a name="toc_Diagnosing-problems" href="#Diagnosing-problems">5 Diagnosing problems</a> +<li><a name="toc_Graphics" href="#Graphics">5 Graphics</a> <ul> -<li><a href="#Debug-options">5.1 Debug options</a> -<li><a href="#Included-graphics-problems">5.2 Included graphics problems</a> +<li><a href="#Encapsulated-PostScript">5.1 Encapsulated PostScript</a> +<li><a href="#Bitmapped-graphics">5.2 Bitmapped graphics</a> </li></ul> <li><a name="toc_Color" href="#Color">6 Color</a> <ul> <li><a href="#Color-specifications">6.1 Color specifications</a> <li><a href="#Color-specials">6.2 Color specials</a> </li></ul> -<li><a name="toc_Credits" href="#Credits">7 Credits</a> -<li><a name="toc_Copying" href="#Copying">8 Copying</a> +<li><a name="toc_Diagnosing-problems" href="#Diagnosing-problems">7 Diagnosing problems</a> +<ul> +<li><a href="#Contact-information">7.1 Contact information</a> +<li><a href="#Debug-options">7.2 Debug options</a> +</li></ul> +<li><a name="toc_Credits" href="#Credits">8 Credits</a> +<li><a name="toc_Copying" href="#Copying">9 Copying</a> <li><a name="toc_Index" href="#Index">Index</a> </li></ul> </div> @@ -71,7 +76,7 @@ Up: <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.6 + <p>This file documents dvipng version 1.9 <p>Corrections or perhaps rewrites of sections are <em>very welcome</em>. @@ -82,11 +87,12 @@ Independent) file into PNG (Portable Network Graphics). <li><a accesskey="2" href="#Installation">Installation</a>: How to compile and install dvipng <li><a accesskey="3" href="#Basic-usage">Basic usage</a>: First things first <li><a accesskey="4" href="#Command_002dline-options">Command-line options</a>: Advanced usage -<li><a accesskey="5" href="#Diagnosing-problems">Diagnosing problems</a>: Problems? +<li><a accesskey="5" href="#Graphics">Graphics</a>: Including PostScript and/or bitmaps <li><a accesskey="6" href="#Color">Color</a>: Using color with dvipng -<li><a accesskey="7" href="#Copying">Copying</a>: GNU General Public License +<li><a accesskey="7" href="#Diagnosing-problems">Diagnosing problems</a>: Problems? <li><a accesskey="8" href="#Credits">Credits</a>: People who have contributed -<li><a accesskey="9" href="#Index">Index</a>: General index +<li><a accesskey="9" href="#Copying">Copying</a>: GNU General Public License +<li><a href="#Index">Index</a>: General index </ul> <div class="node"> @@ -115,7 +121,7 @@ as is possible. The target audience is people who need to generate and regenerate many images again and again. The primary target is the preview-latex (X)Emacs package, a package to preview formulas from within (X)Emacs. Yes, you get to see your formulas in the (X)Emacs -buffer, see <a href="http://preview-latex.sf.net">http://preview-latex.sf.net</a>. +buffer, see <a href="http://www.gnu.org/software/auctex/preview-latex.html">http://www.gnu.org/software/auctex/preview-latex.html</a>. <p>Another example is WeBWorK, an internet-based method for delivering homework problems to students over the internet, giving students @@ -128,23 +134,22 @@ and WYSIWYG editors like LyX. <p>The benefits of `<samp><span class="samp">dvipng</span></samp>'/`<samp><span class="samp">dvigif</span></samp>' include <ul> -<li>Speed. It is a very fast bitmap-rendering code for DVI files. On a -fairly low-end laptop, it takes less than a second to generate 150 -one-formula images. This makes dvipng suitable for generating large -amounts of images on-the-fly, as needed in preview-latex, WeBWorK and -others. +<li>Speed. It is a very fast bitmap-rendering code for DVI files, which +makes it suitable for generating large amounts of images on-the-fly, +as needed in preview-latex, WeBWorK and others. <li>It does not read the postamble, so it can be started before TeX -finishes. There is a –follow switch that makes dvipng wait at EOF for -further output, unless it finds the POST marker that indicates the end -of the DVI. +finishes. There is a `<samp><span class="samp">--follow</span></samp>' switch that makes dvipng wait at +end-of-file for further output, unless it finds the POST marker that +indicates the end of the DVI. <li>Interactive query of options. dvipng can read options interactively through stdin, and all options are usable. It is even possible to change the input file through this interface. - <li>Supports PK, VF, PostScript Type1, and TrueType fonts, color specials -and simple PostScript inclusion specials. + <li>Supports PK, VF, PostScript Type1, and TrueType fonts, subfonts (i.e., +as used in CJK-LaTeX), color specials, and inclusion of PostScript, +PNG, JPEG or GIF images. <li>and more... @@ -205,16 +210,26 @@ may happen that ./configure does not find it; see below. If you do not have it, download it from <a href="http://www.ctan.org">http://www.ctan.org</a> and compile it. I have no experience with this, so I cannot help much here. - <li>FreeType 2 and/or T1lib - - <p>While not strictly necessary, you may want to have FreeType 2 or T1lib -available. Their presence will enable direct support for PostScript -fonts in dvipng, rather than using `<samp><span class="samp">gsftopk</span></samp>' for rendering the -fonts. If you have PostScript versons 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. -If both FreeType 2 and T1lib are present, FreeType will be internally + <li>The font-rendering library FreeType 2 + + <p>While not strictly necessary, FreeType 2 is recommended since dvipng +currently will produce better-quality images with this library +available. It will also enable direct support for PostScript and +TrueType fonts, and subfont support in dvipng. That is, if you want to +render CJK-LaTeX characters, you must have FreeType 2 installed. +With FreeType 2, dvipng will not need to generate bitmapped variants +on disk of the TeX fonts since modern TeX distributions include +PostScript versions of them. Then, you can render images at different +(and unusual) resolutions without cluttering the disk with lots of +bitmapped fonts. + + <li>The font-rendering library T1lib + + <p>An alternative to FreeType 2 is T1lib, but this will enable only +PostScript fonts in dvipng, and will not include subfont support. Also +here, you can render images at different (and unusual) resolutions +without cluttering the disk with lots of bitmapped fonts. If both +FreeType 2 and T1lib are present, FreeType will be internally preferred by dvipng, but T1lib can be chosen at runtime. <li>libpng and libz @@ -246,7 +261,7 @@ various files will be. To do so, run </pre> <p>(Note: if you have fetched dvipng from CVS rather than a regular release, you will have to first generate <samp><span class="file">./configure</span></samp> by running -<code>autoconf</code> 2.53 or later in the <samp><span class="file">preview</span></samp> directory.) +<code>autoconf</code> 2.53 or later.) <p>On many machines, you will not need to specify any options, but if <code>configure</code> cannot determine something on its own, you'll need to @@ -353,8 +368,9 @@ reasonably easy to maintain a bunch of additional packages, since the prefix argument is supported by most <samp><span class="file">configure</span></samp> scripts. <p>You'll have to add something like <samp><span class="file">/home/myself/bin</span></samp> to your -<code>PATH</code> shell variable, if it isn't there already, and similarly set -the <code>INFOPATH</code> variable to be able to access the documentation. +<code>PATH</code> shell variable, if it isn't there already, and similarly +set the <code>INFOPATH</code> and <code>MANPATH</code> variables to be able to +access the documentation. <div class="node"> <p><hr> @@ -395,7 +411,7 @@ of available options, just type <p><hr> <a name="Command-line-options"></a> <a name="Command_002dline-options"></a> -Next: <a rel="next" accesskey="n" href="#Diagnosing-problems">Diagnosing problems</a>, +Next: <a rel="next" accesskey="n" href="#Graphics">Graphics</a>, Previous: <a rel="previous" accesskey="p" href="#Basic-usage">Basic usage</a>, Up: <a rel="up" accesskey="u" href="#Top">Top</a> @@ -425,45 +441,38 @@ Up: <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 `<samp><span class="samp">--help</span></samp>' option. -<pre class="example"> This is dvipng 1.6 Copyright 2002-2005 Jan-Ake Larsson +<pre class="example"> This is ./dvipng 1.9 Copyright 2002-2006 Jan-Ake Larsson - Usage: dvipng [OPTION]... FILENAME[.dvi] + Usage: ./dvipng [OPTION]... FILENAME[.dvi] Options are chosen to be similar to dvips' options where possible: -d # Debug (# is the debug bitmap, 1 if not given) -D # Output resolution -l # Last page to be output - --mode s MetaFont mode (default 'cx') - -M* Don't make PK fonts -o f Output file, '%d' is pagenumber -O c Image offset -p # First page to be output -pp #,#.. Page list to be output -q* Quiet operation - -r* Reverse order of pages -T c Image size (also accepts '-T bbox' and '-T tight') -v* Verbose operation - -x # Override dvi magnification - Interactive query of options These do not correspond to dvips options: -bd # Transparent border width in dots -bd s Transparent border fallback color (TeX-style color) - --bdpi # Set the base (Metafont) resolution -bg s Background color (TeX-style color or 'Transparent') --depth* Output the image depth on stdout --dvinum* Use TeX page numbers in output filenames -fg s Foreground color (TeX-style color) - --follow* Follow mode + --follow* Wait for data at end-of-file + --freetype* FreeType font rendering (default on) --gamma # Control color interpolation - --gif Output GIF images (dvigif default) --height* Output the image height on stdout --noghostscript* Don't use ghostscript for PostScript specials --nogssafer* Don't use -dSAFER in ghostscript calls --picky When a warning occurs, don't output image - --png Output PNG images (dvipng default) --strict When a warning occurs, exit --t1lib* T1lib font rendering (default on) - --truecolor* Truecolor output -Q # Quality (T1lib and PK subsampling) -z # PNG compression level @@ -521,7 +530,7 @@ images do not support full alpha transparency, so in case of GIF output, both variants will use the latter behaviour. See <a href="#Color">Color</a>. <br><dt>`<samp><span class="samp">-d </span><var>num</var></samp>'<dd><a name="index-debugging-15"></a>Set the debug flags, showing what dvipng (thinks it) is doing. This will -work unless dvipng has been compiled without the `<samp><span class="samp">DEBUG</span></samp>' option +work unless dvipng has been compiled without the <code>DEBUG</code> option (not recommended). Set the flags as you need them, use `<samp><span class="samp">-d -1</span></samp>' as the first option for maximum output. See <a href="#Debug-options">Debug options</a>. @@ -543,7 +552,7 @@ is usually 96 dpi) which means the formula is <p>On some high-res screens, the value is instead 120 dpi. Good luck! <br><dt>`<samp><span class="samp">--depth*</span></samp>'<dd><a name="index-baseline-reporting-17"></a><a name="index-depth-reporting-18"></a>Report the depth of the image. This only works reliably when the -LaTeX style `<samp><span class="samp">preview.sty</span></samp>' from preview-latex is used. It +LaTeX style <samp><span class="file">preview.sty</span></samp> from preview-latex is used. It reports the number of pixels from the bottom of the image to the baseline of the image. This can be used for vertical positioning of the image in, e.g., web documents, where one would use (Cascading @@ -561,11 +570,11 @@ there is a foreground color \special in the DVI. The color spec should be in TeX color \special syntax, e.g., 'rgb 1.0 0.0 0.0'. See <a href="#Color">Color</a>. - <br><dt>`<samp><span class="samp">--follow*</span></samp>'<dd><a name="index-follow-mode-20"></a>Enable follow mode. 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 EOF for further output, unless it finds the -POST marker that indicates the end of the DVI. This is similar to -`<samp><span class="samp">tail -f</span></samp>' but for DVI-to-PNG conversion. + <br><dt>`<samp><span class="samp">--follow*</span></samp>'<dd><a name="index-follow-mode-20"></a>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 POST marker that indicates the end of the +DVI. This is similar to `<samp><span class="samp">tail -f</span></samp>' but for DVI-to-PNG conversion. <br><dt>`<samp><span class="samp">--freetype*</span></samp>'<dd><a name="index-FreeType-font-rendering-21"></a>Enable/disable FreeType font rendering (default on). This option is available if the FreeType2 font library was present at compilation time. @@ -584,16 +593,18 @@ color palette. Default value is 1.0. For 0 < <var>num</var> < 1, the fonts will be lighter (more like the background), and for <var>num</var> > 1, the fonts will be darker (more like the foreground). - <br><dt>`<samp><span class="samp">--gif*</span></samp>'<dd><a name="index-GIF-image-format-26"></a>The images are output in the GIF format, if GIF support is -enabled. This is the default for the `<samp><span class="samp">dvigif</span></samp>' binary, which only -will be available when GIF support is enabled. See also the -`<samp><span class="samp">--png</span></samp>' option. + <br><dt>`<samp><span class="samp">--gif*</span></samp>'<dd><a name="index-GIF-image-format-26"></a>The images are output in the GIF format, if GIF support is enabled. +This is the default for the `<samp><span class="samp">dvigif</span></samp>' binary, which only will be +available when GIF support is enabled. GIF images are palette images +(see the `<samp><span class="samp">--palette</span></samp>' option) and does not support true alpha +channels (see the `<samp><span class="samp">--bg</span></samp>' option). See also the `<samp><span class="samp">--png</span></samp>' +option. <br><dt>`<samp><span class="samp">--height*</span></samp>'<dd><a name="index-baseline-reporting-27"></a><a name="index-height-reporting-28"></a>Report the height of the image. This only works reliably when the -LaTeX style `<samp><span class="samp">preview.sty</span></samp>' from preview-latex is used. It +LaTeX style <samp><span class="file">preview.sty</span></samp> from preview-latex is used. It reports the number of pixels from the top of the image to the baseline of the image. The total height of the image is obtained as the -sum of the values reported from –height and the –depth. +sum of the values reported from `<samp><span class="samp">--height</span></samp>' and `<samp><span class="samp">--depth</span></samp>'. <br><dt>`<samp><span class="samp">-l [=]</span><var>num</var></samp>'<dd><a name="index-last-page-printed-29"></a><a name="index-page_002c-last-printed-30"></a><a name="index-physical-page-number_002c-and-_0040samp_007b_002dl_007d-31"></a><a name="index-absolute-page-number_002c-and-_0040samp_007b_002dl_007d-32"></a>The last page printed will be the first one numbered <var>num</var>. Default is the last page in the document. If <var>num</var> is prefixed by an equals @@ -619,7 +630,7 @@ PostScript specials. `<samp><span class="samp">--noghostscript0</span></samp>' t <br><dt>`<samp><span class="samp">--nogssafer*</span></samp>'<dd><a name="index-GhostScript-and-_002ddSAFER-38"></a><a name="index-g_t_002ddSAFER-39"></a>Normally, if GhostScript is used to render PostScript specials, the GhostScript interpreter is run with the option `<samp><span class="samp">-dSAFER</span></samp>'. The -`<samp><span class="samp">-nogssafer</span></samp>' option runs GhostScript without `<samp><span class="samp">-dSAFER</span></samp>'. The +`<samp><span class="samp">--nogssafer</span></samp>' option runs GhostScript without `<samp><span class="samp">-dSAFER</span></samp>'. The `<samp><span class="samp">-dSAFER</span></samp>' option in Ghostscript disables PostScript operators such as deletefile, to prevent possibly malicious PostScript programs from having any effect. @@ -645,7 +656,16 @@ a value to compare with the TeX `<samp><span class="samp">\count0</span></samp>' DVI file. Thus, using `<samp><span class="samp">-p =3</span></samp>' will start with the third page of the document, no matter what the pages are actually numbered. - <br><dt>`<samp><span class="samp">--picky*</span></samp>'<dd><a name="index-no-erroneous-images-47"></a>No images are output when a warning occurs. Normally, dvipng will + <br><dt>`<samp><span class="samp">--palette*</span></samp>'<dd><a name="index-forcing-palette-output-47"></a>Starting from `<samp><span class="samp">dvipng</span></samp>' 1.8, the output PNG will be a truecolor +png when an external image is included, to avoid unnecessary delay and +quality reduction, and enable the EPS translator to draw on a +transparent background and outside of the boundingbox. This switch +will force palette (256-color) output and make `<samp><span class="samp">dvipng</span></samp>' revert to +the old behaviour, where included images were opaque and always +clipped to the boundingbox. This will also override the +`<samp><span class="samp">--truecolor</span></samp>' switch if present. + + <br><dt>`<samp><span class="samp">--picky*</span></samp>'<dd><a name="index-no-erroneous-images-48"></a>No images are output when a warning occurs. Normally, dvipng will output an image in spite of a warning, but there may be something missing in this image. One reason to use this option would be if you have a more complete but slower fallback converter. Mainly, this is @@ -653,10 +673,10 @@ useful for failed figure inclusion and unknown \special occurrences, but warnings will also occur for missing or unknown color specs and missing PK fonts. - <br><dt>`<samp><span class="samp">--png*</span></samp>'<dd><a name="index-PNG-image-format-48"></a>The images are output in the PNG format. This is the default for the + <br><dt>`<samp><span class="samp">--png*</span></samp>'<dd><a name="index-PNG-image-format-49"></a>The images are output in the PNG format. This is the default for the `<samp><span class="samp">dvipng</span></samp>' binary. See also the `<samp><span class="samp">--gif</span></samp>' option. - <br><dt>`<samp><span class="samp">-pp </span><var>firstpage</var><span class="samp">-</span><var>lastpage</var></samp>'<dd><a name="index-page-range-49"></a>Print pages <var>firstpage</var> through <var>lastpage</var>; but not quite + <br><dt>`<samp><span class="samp">-pp </span><var>firstpage</var><span class="samp">-</span><var>lastpage</var></samp>'<dd><a name="index-page-range-50"></a>Print pages <var>firstpage</var> through <var>lastpage</var>; but not quite equivalent to `<samp><span class="samp">-p </span><var>firstpage</var><span class="samp"> -l </span><var>lastpage</var></samp>'. For example, when rendering a book, there may be several instances of a page in the DVI file (one in <code>\frontmatter</code>, one in <code>\mainmatter</code>, and one @@ -674,18 +694,24 @@ will be interpreted as "all pages up to and including 1", if you want a page numbered -1 (only the table of contents, say) put `<samp><span class="samp">-pp -1--1</span></samp>', or more readable, `<samp><span class="samp">-pp -1:-1</span></samp>'. - <br><dt>`<samp><span class="samp">-q*</span></samp>'<dd><a name="index-quiet-operation-50"></a><a name="index-silent-operation-51"></a><a name="index-warnings_002c-suppressing-52"></a>Run quietly. Don't chatter about pages converted, etc. to standard + <br><dt>`<samp><span class="samp">-q*</span></samp>'<dd><a name="index-quiet-operation-51"></a><a name="index-silent-operation-52"></a><a name="index-warnings_002c-suppressing-53"></a>Run quietly. Don't chatter about pages converted, etc. to standard output; report no warnings (only errors) to standard error. - <br><dt>`<samp><span class="samp">-Q </span><var>num</var></samp>'<dd><a name="index-antialiasing-levels_0040r_007b_002c-number-of_007d-53"></a><a name="index-quality-54"></a>Set the quality to <var>num</var>. That is, choose the number of antialiasing -levels for PK and T1lib rendering to be <var>num</var>*<var>num</var>. The default -value is 4 which gives 16 levels of antialiasing for antialiased fonts + <br><dt>`<samp><span class="samp">-Q </span><var>num</var></samp>'<dd><a name="index-antialiasing-levels_0040r_007b_002c-number-of_007d-54"></a><a name="index-quality-55"></a>Set the quality to <var>num</var>. That is, choose the number of antialiasing +levels for PK and T1lib rendering to be <var>num</var>*<var>num</var>+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. - <br><dt>`<samp><span class="samp">-r*</span></samp>'<dd><a name="index-reverse-pagination-55"></a>Toggle output of pages in reverse/forward order. By default, the first + <br><dt>`<samp><span class="samp">-r*</span></samp>'<dd><a name="index-reverse-pagination-56"></a>Toggle output of pages in reverse/forward order. By default, the first page in the DVI is output first. + <br><dt>`<samp><span class="samp">--strict*</span></samp>'<dd><a name="index-exit-on-erroneous-images-57"></a>The program exits when a warning occurs. Normally, dvipng will output +an image in spite of a warning, but there may be something missing in +this image. One reason to use this option would be if you have a more +complete but slower fallback converter. See the `<samp><span class="samp">--picky</span></samp>' option +above for a list of when warnings occur. + <br><dt>`<samp><span class="samp">-T </span><var>image_size</var></samp>'<dd>Set the image size to <var>image_size</var> which can be either of `<samp><span class="samp">bbox</span></samp>', `<samp><span class="samp">tight</span></samp>', or a comma-separated pair of dimensions <var>hsize</var>,<var>vsize</var> such as `<samp><span class="samp">.1in,.3cm</span></samp>'. The default is @@ -695,9 +721,9 @@ the left edge of the paper. This usually gives whitespace above and to the left in the produced image. The value `<samp><span class="samp">tight</span></samp>' will make dvipng only include all ink put on the page, producing neat images. <!-- (@pxref{papersize special}). --> -This option overrides any papersize special in the DVI file. +<!-- This option overrides any papersize special in the DVI file. --> - <br><dt>`<samp><span class="samp">--t1lib*</span></samp>'<dd><a name="index-T1lib-font-rendering-56"></a>Enable/disable T1lib font rendering (default on). This option is + <br><dt>`<samp><span class="samp">--t1lib*</span></samp>'<dd><a name="index-T1lib-font-rendering-58"></a>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 `<samp><span class="samp">gsftopk</span></samp>' for rendering the @@ -709,23 +735,23 @@ 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 `<samp><span class="samp">--freetype0</span></samp>' (see above). - <br><dt>`<samp><span class="samp">--truecolor*</span></samp>'<dd><a name="index-truecolor-output-57"></a>On systems with a fairly new `<samp><span class="samp">libgd</span></samp>', one can choose to generate -truecolor output. This will not be necessary in general unless you -include truecolor images via a PostScript special (i.e., the -`<samp><span class="samp">graphics</span></samp>' or `<samp><span class="samp">graphicx</span></samp>' package). It will lead to longer -execution time, mostly because more data is written to disk. + <br><dt>`<samp><span class="samp">--truecolor*</span></samp>'<dd><a name="index-truecolor-output-59"></a>This will make `<samp><span class="samp">dvipng</span></samp>' generate truecolor output. Note that +truecolor output is automatic if you include an external image in your +DVI, e.g., via a PostScript special (i.e., the `<samp><span class="samp">graphics</span></samp>' or +`<samp><span class="samp">graphicx</span></samp>' package). This switch is overridden by the +`<samp><span class="samp">--palette</span></samp>' switch. <br><dt>`<samp><span class="samp">-v*</span></samp>'<dd>Enable verbose operation. This will currently indicate what fonts is used, in addition to the usual output. - <br><dt>`<samp><span class="samp">-x </span><var>num</var></samp>'<dd><a name="index-magnification_002c-overriding-DVI-58"></a>Set the x magnification ratio to <var>num</var>/1000. Overrides + <br><dt>`<samp><span class="samp">-x </span><var>num</var></samp>'<dd><a name="index-magnification_002c-overriding-DVI-60"></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>`<samp><span class="samp">-z </span><var>num</var></samp>'<dd><a name="index-compression-59"></a>Set the PNG compression level to <var>num</var>. This option is enabled if + <br><dt>`<samp><span class="samp">-z </span><var>num</var></samp>'<dd><a name="index-compression-61"></a>Set the PNG compression level to <var>num</var>. This option is enabled if your `<samp><span class="samp">libgd</span></samp>' is new enough. The default compression level is 1, which selects maximum speed at the price of slightly larger PNGs. For an older `<samp><span class="samp">libgd</span></samp>', the hard-soldered value 5 is used. The include file @@ -743,109 +769,98 @@ correspond directly to the zlib compression levels. <div class="node"> <p><hr> -<a name="Diagnosing-problems"></a> +<a name="Graphics"></a> Next: <a rel="next" accesskey="n" href="#Color">Color</a>, Previous: <a rel="previous" accesskey="p" href="#Command_002dline-options">Command-line options</a>, Up: <a rel="up" accesskey="u" href="#Top">Top</a> </div> -<h2 class="chapter">5 Diagnosing problems</h2> - -<p><a name="index-problems-60"></a><a name="index-trouble-61"></a><a name="index-debugging-62"></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 -yourself in such a situation. - - <p>Bug reports should be sent to -<a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>. +<h2 class="chapter">5 Graphics</h2> - <p>Questions, suggestions for new features, pleas for help, and/or praise -should go to <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>. For more information on this -mailing list, send a message with just the word `help' as subject or -body to <a href="mailto:dvipng-request@nongnu.org">dvipng-request@nongnu.org</a> or look at -<a href="http://lists.nongnu.org/mailman/listinfo/dvipng">http://lists.nongnu.org/mailman/listinfo/dvipng</a>. - - <p>Offers to support further development will be appreciated. For developer -access, ask on <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>. - - <p>For details on the TeX path-searching library, and <code>mktexpk</code> -problems, see <a href="kpathsea.html#Common-problems">Common problems</a>. +<p>`<samp><span class="samp">dvipng</span></samp>' attempts to handle graphics as included by the +`<samp><span class="samp">graphicx</span></samp>' and `<samp><span class="samp">graphics</span></samp>' packages, without the need of +specifying a driver to these packages. This means that it recognizes +the encapsulated postscript inclusion meant for `<samp><span class="samp">dvips</span></samp>', but is +also able (from version 1.8) to include bitmapped graphics, see the +details below. <ul class="menu"> -<li><a accesskey="1" href="#Debug-options">Debug options</a>: Getting diagnostics. -<li><a accesskey="2" href="#Included-graphics-problems">Included graphics problems</a>: Figures are wrongly rendered. +<li><a accesskey="1" href="#Encapsulated-PostScript">Encapsulated PostScript</a>: An internal call to GhostScript +<li><a accesskey="2" href="#Bitmapped-graphics">Bitmapped graphics</a>: PNG, JPEG and GIF </ul> <div class="node"> <p><hr> -<a name="Debug-options"></a> -Next: <a rel="next" accesskey="n" href="#Included-graphics-problems">Included graphics problems</a>, -Up: <a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a> +<a name="Encapsulated-PostScript"></a> +Next: <a rel="next" accesskey="n" href="#Bitmapped-graphics">Bitmapped graphics</a>, +Up: <a rel="up" accesskey="u" href="#Graphics">Graphics</a> </div> -<h3 class="section">5.1 Debug options</h3> - -<p><a name="index-debugging-options-63"></a><a name="index-options_002c-debugging-64"></a> -The `<samp><span class="samp">-d</span></samp>' flag to dvipng helps in tracking down certain errors. The -parameter to this flag is an integer that tells what errors are -currently being tracked. To track a certain class of debug messages, -simply provide the appropriate number given below; if you wish to track -multiple classes, sum the numbers of the classes you wish to track. To -track all classes, you can use <code>-1</code>. - - <p>Some of these debugging options are actually provided by Kpathsea -(see <a href="kpathsea.html#Debugging">Debugging</a>). - - <p>The classes are: - <dl> -<dt>1<dd>Normal dvi op-codes -<br><dt>2<dd>Virtual fonts -<br><dt>4<dd>PK fonts -<br><dt>8<dd>TFM files -<br><dt>16<dd>Glyph rendering -<br><dt>32<dd>FreeType calls -<br><dt>64<dd>Encoding loads -<br><dt>128<dd>Color specials -<br><dt>256<dd>GhostScript specials -<br><dt>512<dd>T1lib calls -<br><dt>1024<dd>Kpathsea <code>stat</code> calls -<br><dt>2048<dd>Kpathsea hash table lookups -<br><dt>4096<dd>Kpathsea path element expansion -<br><dt>8192<dd>Kpathsea path searches - - </dl> - -<div class="node"> +<h3 class="section">5.1 Encapsulated PostScript</h3> + +<p>When an EPS file is included, a call to GhostScript is performed to +produce a bitmapped image that can be included. The default is to +produce an image with transparent background, at the same size as the +DVI page currently being converted to PNG, and include that as +foreground on the PNG. Of course, if the image is to be cropped, that +is done. The included image will be a truecolor image, so for maximum +performance the output PNG will be in truecolor mode as well. + + <p>This conversion needs the `<samp><span class="samp">pngalpha</span></samp>' output device to be present +in your copy of GhostScript. If that device is not present, or you use +the `<samp><span class="samp">--palette</span></samp>' switch or request GIF output, the fallback is to +use the `<samp><span class="samp">png16m</span></samp>' device to produce a cropped opaque image for +inclusion. Other relevant switches are `<samp><span class="samp">--noghostscript</span></samp>' and +`<samp><span class="samp">--nogssafer</span></samp>'. 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 +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 `<samp><span class="samp">\includegraphics</span></samp>' call, as +in this example (using `<samp><span class="samp">graphicx</span></samp>'): + +<pre class="example"> \includegraphics[bb=10 20 100 200]{imagename.eps} +</pre> + <div class="node"> <p><hr> -<a name="Included-graphics-problems"></a> -Previous: <a rel="previous" accesskey="p" href="#Debug-options">Debug options</a>, -Up: <a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a> +<a name="Bitmapped-graphics"></a> +Previous: <a rel="previous" accesskey="p" href="#Encapsulated-PostScript">Encapsulated PostScript</a>, +Up: <a rel="up" accesskey="u" href="#Graphics">Graphics</a> </div> -<h3 class="section">5.2 Included graphics problems</h3> +<h3 class="section">5.2 Bitmapped graphics</h3> -<p><a name="index-graphics-inclusion-problems-65"></a> -The most common problem with including graphics is an incorrect bounding -box. -<!-- (@pxref{Bounding box}). --> -Complain to whoever wrote the software that generated the file if the -bounding box is indeed incorrect. +<p>dvipng can include PNG, JPEG and GIF graphics. When including such +images via `<samp><span class="samp">\includegraphics</span></samp>' you need to specify the bounding +box since TeX itself cannot read them from the files in question. +The bounding box size should be given as `<samp><span class="samp">0 0 w h</span></samp>' in pixels, +e.g., if the file `<samp><span class="samp">imagename.png</span></samp>' is 300x400 pixels, the +inclusion would read - <p>An additional problem is that the image in dvipng is always clipped to -the bounding box. This is because the image is rendered by GhostScript -by an internal call and then copied to the dvipng image. At present no -workaround is known, but there may be one for a future GhostScript. -We'll see. - -<div class="node"> +<pre class="example"> \includegraphics[bb=0 0 300 400]{imagename.png} +</pre> + <p>The default size is the image size in bp (“big points” in TeX +nomenclature or PostScript points as other people have it, 72 per inch). +That is, default resolution will be 72 dpi for included bitmaps, which +is the default size in the few other bitmap-capable drivers that are +known to me (dvipdfm and PDFLaTeX). + + <p>If you want 100 dpi you need to specify the width accordingly. You +just divide your image width by 100: a 135 pixel wide image at 100 dpi +will take up 1.35 inches. If you want 200 dpi you divide by 200, and +so on. Simple, eh? The example above at 200 dpi would be 1.5 inches +wide: + +<pre class="example"> \includegraphics[bb=0 0 300 400,witdh=1.5in]{imagename.png} +</pre> + <div class="node"> <p><hr> <a name="Color"></a> -Next: <a rel="next" accesskey="n" href="#Copying">Copying</a>, -Previous: <a rel="previous" accesskey="p" href="#Diagnosing-problems">Diagnosing problems</a>, +Next: <a rel="next" accesskey="n" href="#Diagnosing-problems">Diagnosing problems</a>, +Previous: <a rel="previous" accesskey="p" href="#Graphics">Graphics</a>, Up: <a rel="up" accesskey="u" href="#Top">Top</a> </div> @@ -871,22 +886,24 @@ Up: <a rel="up" accesskey="u" href="#Color">Color</a> <h3 class="section">6.1 Color specifications</h3> -<p><a name="index-color-specifications-66"></a> +<p><a name="index-color-specifications-63"></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 `<samp><span class="samp">rgb</span></samp>', `<samp><span class="samp">hsb</span></samp>', `<samp><span class="samp">cmy</span></samp>', `<samp><span class="samp">cmyk</span></samp>', or `<samp><span class="samp">gray</span></samp>') followed by the appropriate number of parameters. Thus, the color specification `<samp><span class="samp">rgb 0.3 0.4 0.5</span></samp>' would correspond to the color that is `<samp><span class="samp">0.3 -0.4 0.5</span></samp>' in its red, blue and green values. The color used internally in -dvipng is `<samp><span class="samp">RGB</span></samp>' (discretized to 256 levels), for details on the -formulas used in conversion, see the `<samp><span class="samp">xcolor</span></samp>' documentation. +0.4 0.5</span></samp>' in its red, blue and green values. The color model used +internally in dvipng is `<samp><span class="samp">RGB</span></samp>' (discretized to 256 levels), for +details on the formulas used in conversion, see the `<samp><span class="samp">xcolor</span></samp>' +documentation. <p>By-name color specifications are single (case-dependent) words and are compared with color names defined in `<samp><span class="samp">dvipsnam.def</span></samp>' (from the `<samp><span class="samp">graphics</span></samp>' bundle), `<samp><span class="samp">svgnam.def</span></samp>' and `<samp><span class="samp">xcolor.sty</span></samp>' (from -the `<samp><span class="samp">xcolor</span></samp>' bundle). +the `<samp><span class="samp">xcolor</span></samp>' bundle). See the `<samp><span class="samp">xcolor</span></samp>' documentation for a +list of names and the corresponding colors. - <p>On the command-line, the name `<samp><span class="samp">Transparent</span></samp>' can also be used in as + <p>On the command-line, the name `<samp><span class="samp">Transparent</span></samp>' can also be used as an argument to `<samp><span class="samp">--bg</span></samp>' to choose transparent background. See <a href="#Option-details">Option details</a>. @@ -918,7 +935,7 @@ This saves the current color on the color stack and sets the color to be that given by the color specification. This is the most common way to set a color. - <p>The final version of the `<samp><span class="samp">color</span></samp>' special is just `<samp><span class="samp">color pop</span></samp>', + <p>The final form of the `<samp><span class="samp">color</span></samp>' special is just `<samp><span class="samp">color pop</span></samp>', with no color specification; this says to pop the color last pushed on the color stack from the color stack and set the current color to be that color. @@ -928,40 +945,128 @@ the pages are rendered repeatedly or in reverse order. <div class="node"> <p><hr> +<a name="Diagnosing-problems"></a> +Next: <a rel="next" accesskey="n" href="#Credits">Credits</a>, +Previous: <a rel="previous" accesskey="p" href="#Color">Color</a>, +Up: <a rel="up" accesskey="u" href="#Top">Top</a> + +</div> + +<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> +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 +yourself in such a situation. + +<ul class="menu"> +<li><a accesskey="1" href="#Contact-information">Contact information</a>: Who to ask. +<li><a accesskey="2" href="#Debug-options">Debug options</a>: Getting diagnostics. +</ul> + +<div class="node"> +<p><hr> +<a name="Contact-information"></a> +Next: <a rel="next" accesskey="n" href="#Debug-options">Debug options</a>, +Up: <a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a> + +</div> + +<h3 class="section">7.1 Contact information</h3> + +<p>Bug reports should be sent to +<a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>. + + <p>Questions, suggestions for new features, pleas for help, and/or praise +should go to <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>. For more information on this +mailing list, send a message with just the word `help' as subject or +body to <a href="mailto:dvipng-request@nongnu.org">dvipng-request@nongnu.org</a> or look at +<a href="http://lists.nongnu.org/mailman/listinfo/dvipng">http://lists.nongnu.org/mailman/listinfo/dvipng</a>. + + <p>Offers to support further development will be appreciated. For developer +access, ask on <a href="mailto:dvipng@nongnu.org">dvipng@nongnu.org</a>. + + <p>For details on the TeX path-searching library, and <code>mktexpk</code> +problems, see <a href="kpathsea.html#Common-problems">Common problems</a>. + +<div class="node"> +<p><hr> +<a name="Debug-options"></a> +Previous: <a rel="previous" accesskey="p" href="#Contact-information">Contact information</a>, +Up: <a rel="up" accesskey="u" href="#Diagnosing-problems">Diagnosing problems</a> + +</div> + +<h3 class="section">7.2 Debug options</h3> + +<p>The `<samp><span class="samp">-d</span></samp>' flag to dvipng helps in tracking down certain errors. The +parameter to this flag is an integer that tells what errors are +currently being tracked. To track a certain class of debug messages, +simply provide the appropriate number given below; if you wish to track +multiple classes, sum the numbers of the classes you wish to track. To +track all classes, you can use <code>-1</code>. + + <p>Some of these debugging options are actually provided by Kpathsea +(see <a href="kpathsea.html#Debugging">Debugging</a>). + + <p>The classes are: + <dl> +<dt>1<dd>Normal dvi op-codes +<br><dt>2<dd>Virtual fonts +<br><dt>4<dd>PK fonts +<br><dt>8<dd>TFM files +<br><dt>16<dd>Glyph rendering +<br><dt>32<dd>FreeType calls +<br><dt>64<dd>Encoding loads +<br><dt>128<dd>Color specials +<br><dt>256<dd>GhostScript specials +<br><dt>512<dd>T1lib calls +<br><dt>1024<dd>Kpathsea <code>stat</code> calls +<br><dt>2048<dd>Kpathsea hash table lookups +<br><dt>4096<dd>Kpathsea path element expansion +<br><dt>8192<dd>Kpathsea path searches + + </dl> + +<div class="node"> +<p><hr> <a name="Credits"></a> -Next: <a rel="next" accesskey="n" href="#Index">Index</a>, -Previous: <a rel="previous" accesskey="p" href="#Copying">Copying</a>, +Next: <a rel="next" accesskey="n" href="#Copying">Copying</a>, +Previous: <a rel="previous" accesskey="p" href="#Diagnosing-problems">Diagnosing problems</a>, Up: <a rel="up" accesskey="u" href="#Top">Top</a> </div> -<h2 class="chapter">7 Credits</h2> +<h2 class="chapter">8 Credits</h2> -<p>A number of persons have contributed, if I forget to mention someone, I -apologize. First and foremost we have David Kastrup whose +<p>A number of persons have contributed, if I forget to mention someone, +I apologize. First and foremost we have David Kastrup whose preview-latex project provided the incentive to write this program. -There is also a number of people who have contributed by reporting 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), 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öm, -Ezra Peisach, William H Wheeler, Thomas Klausner, Harald Koenig, Adrian -Bunk, Kevin Smith, and Jason Riedy. +There is also a number of people who have contributed by reporting +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öm, Ezra Peisach, William H Wheeler, Thomas +Klausner, Harald Koenig, Adrian Bunk, Kevin Smith, Jason Riedy, +Wolfram Krause, and Reinhard Kotucha. <div class="node"> <p><hr> <a name="Copying"></a> -Next: <a rel="next" accesskey="n" href="#Credits">Credits</a>, -Previous: <a rel="previous" accesskey="p" href="#Color">Color</a>, +Next: <a rel="next" accesskey="n" href="#Index">Index</a>, +Previous: <a rel="previous" accesskey="p" href="#Credits">Credits</a>, Up: <a rel="up" accesskey="u" href="#Top">Top</a> </div> -<h2 class="chapter">8 Copying</h2> +<h2 class="chapter">9 Copying</h2> <p>This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License @@ -975,18 +1080,19 @@ GNU General Public License for more details. <p>You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software -Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA +02110-1301 USA. <pre class="sp"> </pre> -Copyright © 2002-2005 Jan-Åke Larsson +Copyright © 2002-2006 Jan-Åke Larsson <div class="node"> <p><hr> <a name="Index"></a> -Previous: <a rel="previous" accesskey="p" href="#Credits">Credits</a>, +Previous: <a rel="previous" accesskey="p" href="#Copying">Copying</a>, Up: <a rel="up" accesskey="u" href="#Top">Top</a> </div> @@ -997,23 +1103,24 @@ Up: <a rel="up" accesskey="u" href="#Top">Top</a> <li><a href="#index-g_t_002ddSAFER-39">-dSAFER</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-absolute-page-number_002c-and-_0040samp_007b_002dl_007d-32">absolute page number, and `<samp><span class="samp">-l</span></samp>'</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-absolute-page-number_002c-and-_0040samp_007b_002dp_007d-46">absolute page number, and `<samp><span class="samp">-p</span></samp>'</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-antialiasing-levels_0040r_007b_002c-number-of_007d-53">antialiasing levels<span class="roman">, number of</span></a>: <a href="#Option-details">Option details</a></li> +<li><a href="#index-antialiasing-levels_0040r_007b_002c-number-of_007d-54">antialiasing levels<span class="roman">, number of</span></a>: <a href="#Option-details">Option details</a></li> <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-66">color specifications</a>: <a href="#Color-specifications">Color specifications</a></li> +<li><a href="#index-color-specifications-63">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-59">compression</a>: <a href="#Option-details">Option details</a></li> +<li><a href="#index-compression-61">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-62">debugging</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li> +<li><a href="#index-debugging-66">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-debugging-options-63">debugging options</a>: <a href="#Debug-options">Debug options</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> <li><a href="#index-first-page-printed-43">first page printed</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-follow-mode-20">follow mode</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-font-generation_002c-avoiding-35">font generation, avoiding</a>: <a href="#Option-details">Option details</a></li> +<li><a href="#index-forcing-palette-output-47">forcing palette output</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-foreground-color-_0028option_0029-19">foreground color (option)</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-FreeType-font-rendering-21">FreeType font rendering</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-fuzzy-images-25">fuzzy images</a>: <a href="#Option-details">Option details</a></li> @@ -1021,43 +1128,42 @@ Up: <a rel="up" accesskey="u" href="#Top">Top</a> <li><a href="#index-GhostScript-and-_002ddSAFER-38">GhostScript and -dSAFER</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-GhostScript_002c-turning-off-37">GhostScript, turning off</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-GIF-image-format-26">GIF image format</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-graphics-inclusion-problems-65">graphics inclusion problems</a>: <a href="#Included-graphics-problems">Included graphics problems</a></li> <li><a href="#index-height-reporting-28">height reporting</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-installation_002c-of-dvipng-3">installation, of dvipng</a>: <a href="#Installation">Installation</a></li> <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-58">magnification, overriding DVI</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-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> -<li><a href="#index-no-erroneous-images-47">no erroneous images</a>: <a href="#Option-details">Option details</a></li> +<li><a href="#index-no-erroneous-images-48">no erroneous images</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-offset-pages-42">offset pages</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-option_002c-details-of-8">option, details of</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-options_002c-debugging-64">options, debugging</a>: <a href="#Debug-options">Debug options</a></li> <li><a href="#index-options_002c-dvipng-6">options, dvipng</a>: <a href="#Command_002dline-options">Command-line options</a></li> <li><a href="#index-options_002c-reading-from-standard-input-9">options, reading from standard input</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-options_002c-summary-7">options, summary</a>: <a href="#Option-summary">Option summary</a></li> <li><a href="#index-output-resolution_002c-setting-16">output resolution, setting</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-output_002c-redirecting-40">output, redirecting</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-page-range-49">page range</a>: <a href="#Option-details">Option details</a></li> +<li><a href="#index-page-range-50">page range</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-page_002c-first-printed-44">page, first printed</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-page_002c-last-printed-30">page, last printed</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-physical-page-number_002c-and-_0040samp_007b_002dl_007d-31">physical page number, and `<samp><span class="samp">-l</span></samp>'</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 `<samp><span class="samp">-p</span></samp>'</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-PNG-image-format-48">PNG image format</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-problems-60">problems</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li> -<li><a href="#index-quality-54">quality</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-quiet-operation-50">quiet operation</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-reverse-pagination-55">reverse pagination</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-silent-operation-51">silent operation</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-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> +<li><a href="#index-silent-operation-52">silent operation</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-standard-input_002c-reading-options-from-10">standard input, reading options from</a>: <a href="#Option-details">Option details</a></li> <li><a href="#index-standard-output_002c-output-to-41">standard output, output to</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-T1lib-font-rendering-56">T1lib font rendering</a>: <a href="#Option-details">Option details</a></li> +<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-61">trouble</a>: <a href="#Diagnosing-problems">Diagnosing problems</a></li> -<li><a href="#index-truecolor-output-57">truecolor output</a>: <a href="#Option-details">Option details</a></li> -<li><a href="#index-warnings_002c-suppressing-52">warnings, suppressing</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-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> </ul></body></html> diff --git a/Master/texmf/doc/dvips/dvips.html b/Master/texmf/doc/dvips/dvips.html index 2bac16f53db..e093bb0036e 100644 --- a/Master/texmf/doc/dvips/dvips.html +++ b/Master/texmf/doc/dvips/dvips.html @@ -1,15 +1,15 @@ <html lang="en"> <head> -<title>Dvips: A DVI driver</title> +<title>Dvips: A DVI-to-PostScript translator</title> <meta http-equiv="Content-Type" content="text/html"> -<meta name="description" content="Dvips: A DVI driver"> +<meta name="description" content="Dvips: A DVI-to-PostScript translator"> <meta name="generator" content="makeinfo 4.8"> <link title="Top" rel="top" href="#Top"> <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> <!-- -This manual documents Dvips version 5.95b -(August 2005), a program to translate a DVI file into -PostScript.--> +This manual documents Dvips version 5.96 +(January 2007), a program to translate a DVI file into +PostScript. You may freely use, modify and/or distribute this file.--> <meta http-equiv="Content-Style-Type" content="text/css"> <style type="text/css"><!-- pre.display { font-family:inherit } @@ -24,7 +24,143 @@ PostScript.--> --></style> </head> <body> -<h1 class="settitle">Dvips: A DVI driver</h1> +<h1 class="settitle">Dvips: A DVI-to-PostScript translator</h1> + <div class="shortcontents"> +<h2>Short Contents</h2> +<ul> +<li><a href="#toc_Top">Dvips</a></li> +<li><a href="#toc_Why-Dvips">1 Why use Dvips?</a></li> +<li><a href="#toc_Installation">2 Installation</a></li> +<li><a href="#toc_Invoking-Dvips">3 Invoking Dvips</a></li> +<li><a href="#toc_Paper-size-and-landscape">4 Paper size and landscape orientation</a></li> +<li><a href="#toc_Interaction-with-PostScript">5 Interaction with PostScript</a></li> +<li><a href="#toc_PostScript-fonts">6 PostScript fonts</a></li> +<li><a href="#toc_Color">7 Color</a></li> +<li><a href="#toc_Index">Index</a></li> +</ul> +</div> + + + + <div class="contents"> +<h2>Table of Contents</h2> +<ul> +<li><a name="toc_Top" href="#Top">Dvips</a> +<li><a name="toc_Why-Dvips" href="#Why-Dvips">1 Why use Dvips?</a> +<li><a name="toc_Installation" href="#Installation">2 Installation</a> +<ul> +<li><a href="#config_002eps-installation">2.1 <samp><span class="file">config.ps</span></samp> installation</a> +<li><a href="#PostScript-font-installation">2.2 PostScript font installation</a> +<li><a href="#Ghostscript-installation">2.3 Ghostscript installation</a> +<li><a href="#Diagnosing-problems">2.4 Diagnosing problems</a> +<ul> +<li><a href="#Debug-options">2.4.1 Debug options</a> +<li><a href="#No-output">2.4.2 No output at all</a> +<li><a href="#Small-or-inverted">2.4.3 Output too small or inverted</a> +<li><a href="#Printer-errors">2.4.4 Error messages from printer</a> +<li><a href="#Long-documents-fail">2.4.5 Long documents fail to print</a> +<li><a href="#Including-graphics-fails">2.4.6 Including graphics fails</a> +</li></ul> +</li></ul> +<li><a name="toc_Invoking-Dvips" href="#Invoking-Dvips">3 Invoking Dvips</a> +<ul> +<li><a href="#Basic-usage">3.1 Basic usage of Dvips</a> +<li><a href="#Command_002dline-options">3.2 Command-line options</a> +<ul> +<li><a href="#Option-summary">3.2.1 Option summary</a> +<li><a href="#Option-details">3.2.2 Option details</a> +</li></ul> +<li><a href="#Environment-variables">3.3 Environment variables</a> +<li><a href="#Config-files">3.4 Dvips configuration files</a> +<ul> +<li><a href="#Configuration-file-searching">3.4.1 Configuration file searching</a> +<li><a href="#Configuration-file-commands">3.4.2 Configuration file commands</a> +</li></ul> +</li></ul> +<li><a name="toc_Paper-size-and-landscape" href="#Paper-size-and-landscape">4 Paper size and landscape orientation</a> +<ul> +<li><a href="#papersize-special">4.1 `<samp><span class="samp">papersize</span></samp>' special</a> +<li><a href="#Config-file-paper-sizes">4.2 Configuration file paper size command</a> +<li><a href="#Paper-trays">4.3 Paper trays</a> +</li></ul> +<li><a name="toc_Interaction-with-PostScript" href="#Interaction-with-PostScript">5 Interaction with PostScript</a> +<ul> +<li><a href="#PostScript-figures">5.1 PostScript figures</a> +<ul> +<li><a href="#Bounding-box">5.1.1 The bounding box comment</a> +<li><a href="#_005cincludegraphics">5.1.2 The \includegraphics macro for LaTeX</a> +<li><a href="#EPSF-macros">5.1.3 Using the EPSF macros</a> +<ul> +<li><a href="#EPSF-scaling">5.1.3.1 EPSF scaling</a> +<li><a href="#EPSF-clipping">5.1.3.2 EPSF clipping</a> +</li></ul> +<li><a href="#psfile-special">5.1.4 `<samp><span class="samp">psfile</span></samp>' special</a> +<li><a href="#Dynamic-creation-of-graphics">5.1.5 Dynamic creation of PostScript graphics files</a> +<li><a href="#Fonts-in-figures">5.1.6 Fonts in figures</a> +</li></ul> +<li><a href="#Header-files">5.2 PostScript header files</a> +<ul> +<li><a href="#Including-headers-from-TeX">5.2.1 Including headers from TeX</a> +<li><a href="#Including-headers-from-the-command-line">5.2.2 Including headers from the command line</a> +<li><a href="#Headers-and-memory-usage">5.2.3 Headers and memory usage</a> +</li></ul> +<li><a href="#Literal-PS">5.3 Literal PostScript</a> +<ul> +<li><a href="#_0022-special">5.3.1 <code>"</code> special: Literal PostScript</a> +<li><a href="#ps-special">5.3.2 `<samp><span class="samp">ps</span></samp>' special</a> +<li><a href="#Literal-headers">5.3.3 Literal headers: `<samp><span class="samp">!</span></samp>' <code>\special</code></a> +<li><a href="#PostScript-hooks">5.3.4 PostScript hooks</a> +<li><a href="#Literal-examples">5.3.5 Literal examples</a> +</li></ul> +<li><a href="#Hypertext">5.4 HyperTeXt</a> +<ul> +<li><a href="#Hypertext-caveats">5.4.1 Hypertext caveats</a> +<li><a href="#Hypertext-specials">5.4.2 Hypertext specials</a> +</li></ul> +</li></ul> +<li><a name="toc_PostScript-fonts" href="#PostScript-fonts">6 PostScript fonts</a> +<ul> +<li><a href="#Font-concepts">6.1 Font concepts</a> +<ul> +<li><a href="#Metric-files">6.1.1 Metric files</a> +<li><a href="#Glyph-files">6.1.2 Glyph files</a> +<li><a href="#Virtual-fonts">6.1.3 Virtual fonts</a> +<li><a href="#Encodings">6.1.4 Encodings</a> +<li><a href="#PostScript-typesetting">6.1.5 How PostScript typesets a character</a> +</li></ul> +<li><a href="#Making-a-font-available">6.2 Making a PostScript font available</a> +<li><a href="#Invoking-afm2tfm">6.3 Invoking Afm2tfm</a> +<ul> +<li><a href="#Changing-font-encodings">6.3.1 Changing font encodings</a> +<ul> +<li><a href="#Changing-TeX-encodings">6.3.1.1 `<samp><span class="samp">-t</span></samp>': Changing TeX encodings</a> +<li><a href="#Changing-PostScript-encodings">6.3.1.2 `<samp><span class="samp">-p</span></samp>': Changing PostScript encodings</a> +<li><a href="#Changing-both-encodings">6.3.1.3 `<samp><span class="samp">-T</span></samp>': Changing both TeX and PostScript encodings</a> +<li><a href="#Reencoding-with-Afm2tfm">6.3.1.4 Reencoding with Afm2tfm</a> +<li><a href="#Encoding-file-format">6.3.1.5 Encoding file format</a> +</li></ul> +<li><a href="#Special-font-effects">6.3.2 Special font effects</a> +<li><a href="#Afm2tfm-options">6.3.3 Afm2tfm options</a> +</li></ul> +<li><a href="#psfonts_002emap">6.4 <samp><span class="file">psfonts.map</span></samp>: PostScript font catalog</a> +</li></ul> +<li><a name="toc_Color" href="#Color">7 Color</a> +<ul> +<li><a href="#Color-macro-files">7.1 Color macro files</a> +<li><a href="#User_002ddefinable-colors">7.2 User-definable colors</a> +<li><a href="#Color-subtleties">7.3 Color subtleties</a> +<li><a href="#Ted-Turner">7.4 Printing in black/white after colorizing</a> +<li><a href="#Color-device-configuration">7.5 Color device configuration</a> +<li><a href="#Color-support-details">7.6 Color support details</a> +<ul> +<li><a href="#Color-specifications">7.6.1 Color specifications</a> +<li><a href="#Color-specials">7.6.2 Color specials</a> +</li></ul> +</li></ul> +<li><a name="toc_Index" href="#Index">Index</a> +</li></ul> +</div> + <div class="node"> <p><hr> <a name="Top"></a> @@ -35,9 +171,9 @@ Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> <h2 class="unnumbered">Dvips</h2> -<p>This manual documents Dvips version 5.95b -(August 2005), a program to translate a DVI file into -PostScript. +<p>This manual documents Dvips version 5.96 +(January 2007), a program to translate a DVI file into +PostScript. You may freely use, modify and/or distribute this file. <ul class="menu"> <li><a accesskey="1" href="#Why-Dvips">Why Dvips</a>: Why use Dvips? @@ -178,7 +314,7 @@ printer (output device). Since these are site-specific, <code>make install</code> does not create them; you must create them yourself. <p>(These Dvips configuration files are independent of the Kpathsea -onfiguration file <samp><span class="file">texmf.cnf</span></samp> (see <a href="kpathsea.html#Config-files">Config files</a>). +configuration file <samp><span class="file">texmf.cnf</span></samp> (see <a href="kpathsea.html#Config-files">Config files</a>). <p><a name="index-config_002eproto-10"></a><a name="index-prototype-printer-configuration-file-11"></a><a name="index-printer-configuration-file_002c-prototype-12"></a><a name="index-configuration-files_002c-prototype-13"></a>Dvips configuration files contents and searching are described fully in <a href="#Config-files">Config files</a>. The simplest way to create a new configuration file @@ -863,8 +999,9 @@ you can switch this extension off by using `<samp><span class="samp">-noomega</s send a bug report if you find such problems, see <a href="kpathsea.html#Bugs">Bugs</a>). <br><dt>`<samp><span class="samp">-o </span><var>name</var></samp>'<dd><a name="index-g_t_002do-_0040var_007bname_007d-171"></a><a name="index-output_002c-redirecting-172"></a><a name="index-standard-output_002c-output-to-173"></a>Send output to the file <var>name</var>. If `<samp><span class="samp">-o</span></samp>' is specified without -<var>name</var>, the default is `<samp><var>file</var><span class="samp">.ps</span></samp>' where the input DVI file -was `<samp><var>file</var><span class="samp">.dvi</span></samp>'. If `<samp><span class="samp">-o</span></samp>' isn't given at all, the +<var>name</var> (i.e., it is the last thing on the command line), the +default is `<samp><var>file</var><span class="samp">.ps</span></samp>' where the input DVI file was +`<samp><var>file</var><span class="samp">.dvi</span></samp>'. If `<samp><span class="samp">-o</span></samp>' isn't given at all, the configuration file default is used. <p><a name="index-popen-_0040r_007bfor-output_007d-174"></a><a name="index-g_t_002d-_0040r_007bas-output-filename_007d-175"></a><a name="index-g_t_0021-_0040r_007bstarting-output-filename_007d-176"></a><a name="index-g_t_007c-_0040r_007bstarting-output-filename_007d-177"></a><a name="index-lpr-spooler_002c-MS_002dDOS-emulation-178"></a><a name="index-spooling-to-lpr-on-MS_002dDOS-179"></a>If <var>name</var> is `<samp><span class="samp">-</span></samp>', output goes to standard output. If the first @@ -931,9 +1068,11 @@ output; report no warnings (only errors) to standard error. <br><dt>`<samp><span class="samp">-r*</span></samp>'<dd><a name="index-g_t_002dr-199"></a><a name="index-reverse-pagination-200"></a>Output pages in reverse order. By default, page 1 is output first. - <br><dt>`<samp><span class="samp">-R</span></samp>'<dd><a name="index-g_t_002dR-201"></a><a name="index-security-202"></a><a name="index-shell-command-execution_002c-disabling-203"></a><a name="index-absolute-filenames_002c-disabling-204"></a>Run securely. This disables shell command execution in + <br><dt>`<samp><span class="samp">-R</span></samp>'<dd><a name="index-g_t_002dR-201"></a><a name="index-security-202"></a><a name="index-shell-command-execution_002c-disabling-203"></a><a name="index-absolute-filenames_002c-disabling-204"></a>Run securely. `<samp><span class="samp">-R2</span></samp>' disables both shell command execution in <code>\special</code> (via `<samp><span class="samp">`</span></samp>', see <a href="#Dynamic-creation-of-graphics">Dynamic creation of graphics</a>) -and config files (via the `<samp><span class="samp">E</span></samp>' option, see <a href="#Configuration-file-commands">Configuration file commands</a>), and opening of any absolute filenames. +and config files (via the `<samp><span class="samp">E</span></samp>' option, see <a href="#Configuration-file-commands">Configuration file commands</a>) and opening of any absolute filenames. `<samp><span class="samp">-R1</span></samp>', the +default, forbids shell escapes but allows absolute filenames. +`<samp><span class="samp">-R0</span></samp>' allows both. <br><dt>`<samp><span class="samp">-s*</span></samp>'<dd><a name="index-g_t_002ds-205"></a><a name="index-save_002frestore_002c-generating-global-206"></a>Enclose the output in a global save/restore pair. This causes the file to not be truly conformant, and is thus not recommended, but is useful @@ -954,9 +1093,10 @@ for `<samp><span class="samp">landscape</span></samp>'. You should not use any TeX writes a `<samp><span class="samp">papersize</span></samp>' special, as is done by some LaTeX packages, e.g., `<samp><span class="samp">hyperref.sty</span></samp>'. - <br><dt>`<samp><span class="samp">-T </span><var>hsize</var><span class="samp">,</span><var>vsize</var></samp>'<dd><a name="index-g_t_002dT-_0040var_007bhsize_007d_002c_0040var_007bvsize_007d-218"></a>Set the paper size to (<var>hsize</var>,<var>vsize</var>), a comma-separated pair -of dimensions such as `<samp><span class="samp">.1in,-.3cm</span></samp>' (see <a href="#papersize-special">papersize special</a>). It -overrides any paper size special in the DVI file. + <br><dt>`<samp><span class="samp">-T </span><var>hsize</var><span class="samp">,</span><var>vsize</var></samp>'<dd><a name="index-g_t_002dT-_0040var_007bhsize_007d_002c_0040var_007bvsize_007d-218"></a>Set the paper size to (<var>hsize</var>,<var>vsize</var>), a comma-separated +pair of dimensions such as `<samp><span class="samp">.1in,-.3cm</span></samp>' (see <a href="#papersize-special">papersize special</a>). It overrides any paper size special in the DVI file. Be +careful, as the paper size will stick to a predefined size if there is +one close enough. To disable this behavior, use `<samp><span class="samp">-tunknown</span></samp>'. <br><dt>`<samp><span class="samp">-u </span><var>psmapfile</var></samp>'<dd><a name="index-g_t_002du-_0040var_007bpsmapfile_007d-219"></a><a name="index-PostScript-font-alias-file-220"></a><a name="index-resident-fonts_002c-different-in-different-printers-221"></a>Set <var>psmapfile</var> to be the file that dvips uses for looking up PostScript font aliases. If <var>psmapfile</var> begins with a `<samp><span class="samp">+</span></samp>' @@ -1320,8 +1460,8 @@ about special characteristics of a particular printer. <br><dt>`<samp><span class="samp">Z*</span></samp>'<dd><a name="index-Z-_0040r_007bconfig-command-_0028compression_0029_007d-326"></a>Compress bitmap fonts. Same as `<samp><span class="samp">-Z</span></samp>' (see <a href="#Option-details">Option details</a>). <br><dt>`<samp><span class="samp">z*</span></samp>'<dd><a name="index-z-_0040r_007bconfig-command-_0028secure-mode_0029_007d-327"></a>Disables execution of system commands, like `<samp><span class="samp">-R</span></samp>' -(see <a href="#Option-details">Option details</a>). If `<samp><span class="samp">-R1</span></samp>' is given to disable system -commands, however, this will not re-enable them. +(see <a href="#Option-details">Option details</a>). If `<samp><span class="samp">-R</span></samp>' is specified +on the command line, that takes precedence. </dl> @@ -1459,11 +1599,11 @@ For example: </pre> <p>When Dvips has a paper format name given on the command line, it looks for a match by the <var>name</var>; when it has a `<samp><span class="samp">papersize</span></samp>' special, -it looks for a match by dimensions. The first match found (in the order -the paper size information is found in the configuration file) is used. -If nothing matches, a warning is printed and the first paper size is -used. The dimensions must match within a quarter of an inch. Landscape -mode for all paper sizes is automatically supported. +it looks for a match by dimensions. The best match found (from the +paper size information in the configuration file) is used. If nothing +matches, a warning is printed and the first paper size is used. The +dimensions must match within 5bp. Landscape mode for all paper sizes +is automatically supported. <p>If your printer has a command to set a special paper size, then give dimensions of `<samp><span class="samp">0in 0in</span></samp>'; the PostScript code that sets the paper @@ -4676,141 +4816,6 @@ Up: <a rel="up" accesskey="u" href="#Top">Top</a> <li><a href="#index-Z-_0040r_007bconfig-command-_0028compression_0029_007d-326"><code>Z </code><span class="roman">config command (compression)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li> <li><a href="#index-z-_0040r_007bconfig-command-_0028secure-mode_0029_007d-327"><code>z </code><span class="roman">config command (secure mode)</span></a>: <a href="#Configuration-file-commands">Configuration file commands</a></li> <li><a href="#index-g_t_007c-_0040r_007bstarting-output-filename_007d-177"><code>| </code><span class="roman">starting output filename</span></a>: <a href="#Option-details">Option details</a></li> - </ul> -<div class="shortcontents"> -<h2>Short Contents</h2> -<ul> -<li><a href="#toc_Top">Dvips</a></li> -<li><a href="#toc_Why-Dvips">1 Why use Dvips?</a></li> -<li><a href="#toc_Installation">2 Installation</a></li> -<li><a href="#toc_Invoking-Dvips">3 Invoking Dvips</a></li> -<li><a href="#toc_Paper-size-and-landscape">4 Paper size and landscape orientation</a></li> -<li><a href="#toc_Interaction-with-PostScript">5 Interaction with PostScript</a></li> -<li><a href="#toc_PostScript-fonts">6 PostScript fonts</a></li> -<li><a href="#toc_Color">7 Color</a></li> -<li><a href="#toc_Index">Index</a></li> -</ul> -</div> - - <div class="contents"> -<h2>Table of Contents</h2> -<ul> -<li><a name="toc_Top" href="#Top">Dvips</a> -<li><a name="toc_Why-Dvips" href="#Why-Dvips">1 Why use Dvips?</a> -<li><a name="toc_Installation" href="#Installation">2 Installation</a> -<ul> -<li><a href="#config_002eps-installation">2.1 <samp><span class="file">config.ps</span></samp> installation</a> -<li><a href="#PostScript-font-installation">2.2 PostScript font installation</a> -<li><a href="#Ghostscript-installation">2.3 Ghostscript installation</a> -<li><a href="#Diagnosing-problems">2.4 Diagnosing problems</a> -<ul> -<li><a href="#Debug-options">2.4.1 Debug options</a> -<li><a href="#No-output">2.4.2 No output at all</a> -<li><a href="#Small-or-inverted">2.4.3 Output too small or inverted</a> -<li><a href="#Printer-errors">2.4.4 Error messages from printer</a> -<li><a href="#Long-documents-fail">2.4.5 Long documents fail to print</a> -<li><a href="#Including-graphics-fails">2.4.6 Including graphics fails</a> -</li></ul> -</li></ul> -<li><a name="toc_Invoking-Dvips" href="#Invoking-Dvips">3 Invoking Dvips</a> -<ul> -<li><a href="#Basic-usage">3.1 Basic usage of Dvips</a> -<li><a href="#Command_002dline-options">3.2 Command-line options</a> -<ul> -<li><a href="#Option-summary">3.2.1 Option summary</a> -<li><a href="#Option-details">3.2.2 Option details</a> -</li></ul> -<li><a href="#Environment-variables">3.3 Environment variables</a> -<li><a href="#Config-files">3.4 Dvips configuration files</a> -<ul> -<li><a href="#Configuration-file-searching">3.4.1 Configuration file searching</a> -<li><a href="#Configuration-file-commands">3.4.2 Configuration file commands</a> -</li></ul> -</li></ul> -<li><a name="toc_Paper-size-and-landscape" href="#Paper-size-and-landscape">4 Paper size and landscape orientation</a> -<ul> -<li><a href="#papersize-special">4.1 `<samp><span class="samp">papersize</span></samp>' special</a> -<li><a href="#Config-file-paper-sizes">4.2 Configuration file paper size command</a> -<li><a href="#Paper-trays">4.3 Paper trays</a> -</li></ul> -<li><a name="toc_Interaction-with-PostScript" href="#Interaction-with-PostScript">5 Interaction with PostScript</a> -<ul> -<li><a href="#PostScript-figures">5.1 PostScript figures</a> -<ul> -<li><a href="#Bounding-box">5.1.1 The bounding box comment</a> -<li><a href="#_005cincludegraphics">5.1.2 The \includegraphics macro for LaTeX</a> -<li><a href="#EPSF-macros">5.1.3 Using the EPSF macros</a> -<ul> -<li><a href="#EPSF-scaling">5.1.3.1 EPSF scaling</a> -<li><a href="#EPSF-clipping">5.1.3.2 EPSF clipping</a> -</li></ul> -<li><a href="#psfile-special">5.1.4 `<samp><span class="samp">psfile</span></samp>' special</a> -<li><a href="#Dynamic-creation-of-graphics">5.1.5 Dynamic creation of PostScript graphics files</a> -<li><a href="#Fonts-in-figures">5.1.6 Fonts in figures</a> -</li></ul> -<li><a href="#Header-files">5.2 PostScript header files</a> -<ul> -<li><a href="#Including-headers-from-TeX">5.2.1 Including headers from TeX</a> -<li><a href="#Including-headers-from-the-command-line">5.2.2 Including headers from the command line</a> -<li><a href="#Headers-and-memory-usage">5.2.3 Headers and memory usage</a> -</li></ul> -<li><a href="#Literal-PS">5.3 Literal PostScript</a> -<ul> -<li><a href="#_0022-special">5.3.1 <code>"</code> special: Literal PostScript</a> -<li><a href="#ps-special">5.3.2 `<samp><span class="samp">ps</span></samp>' special</a> -<li><a href="#Literal-headers">5.3.3 Literal headers: `<samp><span class="samp">!</span></samp>' <code>\special</code></a> -<li><a href="#PostScript-hooks">5.3.4 PostScript hooks</a> -<li><a href="#Literal-examples">5.3.5 Literal examples</a> -</li></ul> -<li><a href="#Hypertext">5.4 HyperTeXt</a> -<ul> -<li><a href="#Hypertext-caveats">5.4.1 Hypertext caveats</a> -<li><a href="#Hypertext-specials">5.4.2 Hypertext specials</a> -</li></ul> -</li></ul> -<li><a name="toc_PostScript-fonts" href="#PostScript-fonts">6 PostScript fonts</a> -<ul> -<li><a href="#Font-concepts">6.1 Font concepts</a> -<ul> -<li><a href="#Metric-files">6.1.1 Metric files</a> -<li><a href="#Glyph-files">6.1.2 Glyph files</a> -<li><a href="#Virtual-fonts">6.1.3 Virtual fonts</a> -<li><a href="#Encodings">6.1.4 Encodings</a> -<li><a href="#PostScript-typesetting">6.1.5 How PostScript typesets a character</a> -</li></ul> -<li><a href="#Making-a-font-available">6.2 Making a PostScript font available</a> -<li><a href="#Invoking-afm2tfm">6.3 Invoking Afm2tfm</a> -<ul> -<li><a href="#Changing-font-encodings">6.3.1 Changing font encodings</a> -<ul> -<li><a href="#Changing-TeX-encodings">6.3.1.1 `<samp><span class="samp">-t</span></samp>': Changing TeX encodings</a> -<li><a href="#Changing-PostScript-encodings">6.3.1.2 `<samp><span class="samp">-p</span></samp>': Changing PostScript encodings</a> -<li><a href="#Changing-both-encodings">6.3.1.3 `<samp><span class="samp">-T</span></samp>': Changing both TeX and PostScript encodings</a> -<li><a href="#Reencoding-with-Afm2tfm">6.3.1.4 Reencoding with Afm2tfm</a> -<li><a href="#Encoding-file-format">6.3.1.5 Encoding file format</a> -</li></ul> -<li><a href="#Special-font-effects">6.3.2 Special font effects</a> -<li><a href="#Afm2tfm-options">6.3.3 Afm2tfm options</a> -</li></ul> -<li><a href="#psfonts_002emap">6.4 <samp><span class="file">psfonts.map</span></samp>: PostScript font catalog</a> -</li></ul> -<li><a name="toc_Color" href="#Color">7 Color</a> -<ul> -<li><a href="#Color-macro-files">7.1 Color macro files</a> -<li><a href="#User_002ddefinable-colors">7.2 User-definable colors</a> -<li><a href="#Color-subtleties">7.3 Color subtleties</a> -<li><a href="#Ted-Turner">7.4 Printing in black/white after colorizing</a> -<li><a href="#Color-device-configuration">7.5 Color device configuration</a> -<li><a href="#Color-support-details">7.6 Color support details</a> -<ul> -<li><a href="#Color-specifications">7.6.1 Color specifications</a> -<li><a href="#Color-specials">7.6.2 Color specials</a> -</li></ul> -</li></ul> -<li><a name="toc_Index" href="#Index">Index</a> -</li></ul> -</div> - -<!-- INSTALLONLY --> + </ul><!-- INSTALLONLY --> </body></html> diff --git a/Master/texmf/doc/dvips/dvips.pdf b/Master/texmf/doc/dvips/dvips.pdf Binary files differindex f94ee0d887d..f660e8ba78d 100644 --- a/Master/texmf/doc/dvips/dvips.pdf +++ b/Master/texmf/doc/dvips/dvips.pdf diff --git a/Master/texmf/doc/info/dvipng.info b/Master/texmf/doc/info/dvipng.info index a575c11a9fd..e2f4323ec73 100644 --- a/Master/texmf/doc/info/dvipng.info +++ b/Master/texmf/doc/info/dvipng.info @@ -1,4 +1,5 @@ -This is dvipng.info, produced by makeinfo version 4.8 from dvipng.texi. +This is dvipng.info, produced by makeinfo version 4.8 from +../../../texk/dvipng/dvipng.texi. INFO-DIR-SECTION TeX START-INFO-DIR-ENTRY @@ -15,7 +16,7 @@ dvipng This manual documents dvipng, a program to translate a DVI (DeVice Independent) file into PNG (Portable Network Graphics). - This file documents dvipng version 1.6 + This file documents dvipng version 1.9 Corrections or perhaps rewrites of sections are _very welcome_. @@ -27,10 +28,11 @@ Independent) file into PNG (Portable Network Graphics). * Installation:: How to compile and install dvipng * Basic usage:: First things first * Command-line options:: Advanced usage -* Diagnosing problems:: Problems? +* Graphics:: Including PostScript and/or bitmaps * Color:: Using color with dvipng -* Copying:: GNU General Public License +* Diagnosing problems:: Problems? * Credits:: People who have contributed +* Copying:: GNU General Public License * Index:: General index @@ -50,7 +52,7 @@ fast as is possible. The target audience is people who need to generate and regenerate many images again and again. The primary target is the preview-latex (X)Emacs package, a package to preview formulas from within (X)Emacs. Yes, you get to see your formulas in the (X)Emacs -buffer, see `http://preview-latex.sf.net'. +buffer, see `http://www.gnu.org/software/auctex/preview-latex.html'. Another example is WeBWorK, an internet-based method for delivering homework problems to students over the internet, giving students @@ -62,23 +64,22 @@ latex2html and WYSIWYG editors like LyX. The benefits of `dvipng'/`dvigif' include - * Speed. It is a very fast bitmap-rendering code for DVI files. On a - fairly low-end laptop, it takes less than a second to generate 150 - one-formula images. This makes dvipng suitable for generating large - amounts of images on-the-fly, as needed in preview-latex, WeBWorK - and others. + * Speed. It is a very fast bitmap-rendering code for DVI files, which + makes it suitable for generating large amounts of images + on-the-fly, as needed in preview-latex, WeBWorK and others. * It does not read the postamble, so it can be started before TeX - finishes. There is a -follow switch that makes dvipng wait at EOF - for further output, unless it finds the POST marker that indicates - the end of the DVI. + finishes. There is a `--follow' switch that makes dvipng wait at + end-of-file for further output, unless it finds the POST marker + that indicates the end of the DVI. * Interactive query of options. dvipng can read options interactively through stdin, and all options are usable. It is even possible to change the input file through this interface. - * Supports PK, VF, PostScript Type1, and TrueType fonts, color - specials and simple PostScript inclusion specials. + * Supports PK, VF, PostScript Type1, and TrueType fonts, subfonts + (i.e., as used in CJK-LaTeX), color specials, and inclusion of + PostScript, PNG, JPEG or GIF images. * and more... @@ -122,18 +123,27 @@ File: dvipng.info, Node: Prerequisites, Next: Configure, Up: Installation not have it, download it from `http://www.ctan.org' and compile it. I have no experience with this, so I cannot help much here. - * FreeType 2 and/or T1lib + * The font-rendering library FreeType 2 - While not strictly necessary, you may want to have FreeType 2 or - T1lib available. Their presence will enable direct support for - PostScript fonts in dvipng, rather than using `gsftopk' for - rendering the fonts. If you have PostScript versons 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. If both FreeType 2 and T1lib are - present, FreeType will be internally preferred by dvipng, but - T1lib can be chosen at runtime. + While not strictly necessary, FreeType 2 is recommended since + dvipng currently will produce better-quality images with this + library available. It will also enable direct support for + PostScript and TrueType fonts, and subfont support in dvipng. That + is, if you want to render CJK-LaTeX characters, you must have + FreeType 2 installed. With FreeType 2, dvipng will not need to + generate bitmapped variants on disk of the TeX fonts since modern + TeX distributions include PostScript versions of them. Then, you + can render images at different (and unusual) resolutions without + cluttering the disk with lots of bitmapped fonts. + + * The font-rendering library T1lib + + An alternative to FreeType 2 is T1lib, but this will enable only + PostScript fonts in dvipng, and will not include subfont support. + Also here, you can render images at different (and unusual) + resolutions without cluttering the disk with lots of bitmapped + fonts. If both FreeType 2 and T1lib are present, FreeType will be + internally preferred by dvipng, but T1lib can be chosen at runtime. * libpng and libz @@ -159,7 +169,7 @@ various files will be. To do so, run (Note: if you have fetched dvipng from CVS rather than a regular release, you will have to first generate `./configure' by running -`autoconf' 2.53 or later in the `preview' directory.) +`autoconf' 2.53 or later.) On many machines, you will not need to specify any options, but if `configure' cannot determine something on its own, you'll need to help @@ -209,8 +219,9 @@ File: dvipng.info, Node: Build/install, Next: Installation outside the texmf t Once `configure' has been run, simply enter make - at the prompt to compile the C code, and build the documentation -files. To install the files into the locations chosen earlier, type + +at the prompt to compile the C code, and build the documentation files. +To install the files into the locations chosen earlier, type make install @@ -250,7 +261,8 @@ supported by most `configure' scripts. You'll have to add something like `/home/myself/bin' to your `PATH' shell variable, if it isn't there already, and similarly set the -`INFOPATH' variable to be able to access the documentation. +`INFOPATH' and `MANPATH' variables to be able to access the +documentation. File: dvipng.info, Node: Basic usage, Next: Command-line options, Prev: Installation, Up: Top @@ -283,7 +295,7 @@ summary of available options, just type dvipng --help -File: dvipng.info, Node: Command-line options, Next: Diagnosing problems, Prev: Basic usage, Up: Top +File: dvipng.info, Node: Command-line options, Next: Graphics, Prev: Basic usage, Up: Top 4 Command-line options ********************** @@ -305,45 +317,38 @@ File: dvipng.info, Node: Option summary, Next: Option details, Up: Command-li Here is a handy summary of the options; it is printed out when you run dvipng with no arguments or with the standard `--help' option. - This is dvipng 1.6 Copyright 2002-2005 Jan-Ake Larsson + This is ./dvipng 1.9 Copyright 2002-2006 Jan-Ake Larsson - Usage: dvipng [OPTION]... FILENAME[.dvi] + Usage: ./dvipng [OPTION]... FILENAME[.dvi] Options are chosen to be similar to dvips' options where possible: -d # Debug (# is the debug bitmap, 1 if not given) -D # Output resolution -l # Last page to be output - --mode s MetaFont mode (default 'cx') - -M* Don't make PK fonts -o f Output file, '%d' is pagenumber -O c Image offset -p # First page to be output -pp #,#.. Page list to be output -q* Quiet operation - -r* Reverse order of pages -T c Image size (also accepts '-T bbox' and '-T tight') -v* Verbose operation - -x # Override dvi magnification - Interactive query of options These do not correspond to dvips options: -bd # Transparent border width in dots -bd s Transparent border fallback color (TeX-style color) - --bdpi # Set the base (Metafont) resolution -bg s Background color (TeX-style color or 'Transparent') --depth* Output the image depth on stdout --dvinum* Use TeX page numbers in output filenames -fg s Foreground color (TeX-style color) - --follow* Follow mode + --follow* Wait for data at end-of-file + --freetype* FreeType font rendering (default on) --gamma # Control color interpolation - --gif Output GIF images (dvigif default) --height* Output the image height on stdout --noghostscript* Don't use ghostscript for PostScript specials --nogssafer* Don't use -dSAFER in ghostscript calls --picky When a warning occurs, don't output image - --png Output PNG images (dvipng default) --strict When a warning occurs, exit --t1lib* T1lib font rendering (default on) - --truecolor* Truecolor output -Q # Quality (T1lib and PK subsampling) -z # PNG compression level @@ -447,11 +452,12 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. 0.0 0.0'. *Note Color::. `--follow*' - Enable follow mode. 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 EOF for further output, unless it - finds the POST marker that indicates the end of the DVI. This is - similar to `tail -f' but for DVI-to-PNG conversion. + 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 POST marker that indicates the + end of the DVI. This is similar to `tail -f' but for DVI-to-PNG + conversion. `--freetype*' Enable/disable FreeType font rendering (default on). This option is @@ -474,17 +480,18 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. fonts will be darker (more like the foreground). `--gif*' - The images are output in the GIF format, if GIF support is - enabled. This is the default for the `dvigif' binary, which only - will be available when GIF support is enabled. See also the - `--png' option. + The images are output in the GIF format, if GIF support is enabled. + This is the default for the `dvigif' binary, which only will be + available when GIF support is enabled. GIF images are palette + images (see the `--palette' option) and does not support true alpha + channels (see the `--bg' option). See also the `--png' option. `--height*' Report the height of the image. This only works reliably when the LaTeX style `preview.sty' from preview-latex is used. It reports the number of pixels from the top of the image to the baseline of the image. The total height of the image is obtained as the sum of - the values reported from -height and the -depth. + the values reported from `--height' and `--depth'. `-l [=]NUM' The last page printed will be the first one numbered NUM. Default @@ -516,7 +523,7 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. `--nogssafer*' Normally, if GhostScript is used to render PostScript specials, the GhostScript interpreter is run with the option `-dSAFER'. The - `-nogssafer' option runs GhostScript without `-dSAFER'. The + `--nogssafer' option runs GhostScript without `-dSAFER'. The `-dSAFER' option in Ghostscript disables PostScript operators such as deletefile, to prevent possibly malicious PostScript programs from having any effect. @@ -543,6 +550,16 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. DVI file. Thus, using `-p =3' will start with the third page of the document, no matter what the pages are actually numbered. +`--palette*' + Starting from `dvipng' 1.8, the output PNG will be a truecolor png + when an external image is included, to avoid unnecessary delay and + quality reduction, and enable the EPS translator to draw on a + transparent background and outside of the boundingbox. This switch + will force palette (256-color) output and make `dvipng' revert to + the old behaviour, where included images were opaque and always + clipped to the boundingbox. This will also override the + `--truecolor' switch if present. + `--picky*' No images are output when a warning occurs. Normally, dvipng will output an image in spite of a warning, but there may be something @@ -580,15 +597,22 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. `-Q NUM' Set the quality to NUM. That is, choose the number of antialiasing - levels for PK and T1lib rendering to be NUM*NUM. The default value - is 4 which gives 16 levels of antialiasing for antialiased fonts - from these two. If FreeType is available, its rendering is + levels for PK and T1lib rendering to be NUM*NUM+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. `-r*' Toggle output of pages in reverse/forward order. By default, the first page in the DVI is output first. +`--strict*' + The program exits when a warning occurs. Normally, dvipng will + output an image in spite of a warning, but there may be something + missing in this image. One reason to use this option would be if + you have a more complete but slower fallback converter. See the + `--picky' option above for a list of when warnings occur. + `-T IMAGE_SIZE' Set the image size to IMAGE_SIZE which can be either of `bbox', `tight', or a comma-separated pair of dimensions HSIZE,VSIZE such @@ -597,8 +621,7 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. located 1in from the top and 1in from the left edge of the paper. This usually gives whitespace above and to the left in the produced image. The value `tight' will make dvipng only include - all ink put on the page, producing neat images. This option - overrides any papersize special in the DVI file. + all ink put on the page, producing neat images. `--t1lib*' Enable/disable T1lib font rendering (default on). This option is @@ -615,11 +638,11 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. `--freetype0' (see above). `--truecolor*' - On systems with a fairly new `libgd', one can choose to generate - truecolor output. This will not be necessary in general unless you - include truecolor images via a PostScript special (i.e., the - `graphics' or `graphicx' package). It will lead to longer - execution time, mostly because more data is written to disk. + This will make `dvipng' generate truecolor output. Note that + truecolor output is automatic if you include an external image in + your DVI, e.g., via a PostScript special (i.e., the `graphics' or + `graphicx' package). This switch is overridden by the `--palette' + switch. `-v*' Enable verbose operation. This will currently indicate what fonts @@ -649,113 +672,80 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. directly to the zlib compression levels. -File: dvipng.info, Node: Diagnosing problems, Next: Color, Prev: Command-line options, Up: Top - -5 Diagnosing problems -********************* - -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 -yourself in such a situation. - - Bug reports should be sent to <dvipng@nongnu.org>. - - Questions, suggestions for new features, pleas for help, and/or -praise should go to <dvipng@nongnu.org>. For more information on this -mailing list, send a message with just the word `help' as subject or -body to <dvipng-request@nongnu.org> or look at -`http://lists.nongnu.org/mailman/listinfo/dvipng'. +File: dvipng.info, Node: Graphics, Next: Color, Prev: Command-line options, Up: Top - Offers to support further development will be appreciated. For -developer access, ask on <dvipng@nongnu.org>. +5 Graphics +********** - For details on the TeX path-searching library, and `mktexpk' -problems, *note Common problems: (kpathsea)Common problems. +`dvipng' attempts to handle graphics as included by the `graphicx' and +`graphics' packages, without the need of specifying a driver to these +packages. This means that it recognizes the encapsulated postscript +inclusion meant for `dvips', but is also able (from version 1.8) to +include bitmapped graphics, see the details below. * Menu: -* Debug options:: Getting diagnostics. -* Included graphics problems:: Figures are wrongly rendered. +* Encapsulated PostScript:: An internal call to GhostScript +* Bitmapped graphics:: PNG, JPEG and GIF -File: dvipng.info, Node: Debug options, Next: Included graphics problems, Up: Diagnosing problems - -5.1 Debug options -================= - -The `-d' flag to dvipng helps in tracking down certain errors. The -parameter to this flag is an integer that tells what errors are -currently being tracked. To track a certain class of debug messages, -simply provide the appropriate number given below; if you wish to track -multiple classes, sum the numbers of the classes you wish to track. To -track all classes, you can use `-1'. - - Some of these debugging options are actually provided by Kpathsea -(*note Debugging: (kpathsea)Debugging.). - - The classes are: -1 - Normal dvi op-codes - -2 - Virtual fonts - -4 - PK fonts - -8 - TFM files - -16 - Glyph rendering - -32 - FreeType calls - -64 - Encoding loads - -128 - Color specials - -256 - GhostScript specials +File: dvipng.info, Node: Encapsulated PostScript, Next: Bitmapped graphics, Up: Graphics + +5.1 Encapsulated PostScript +=========================== + +When an EPS file is included, a call to GhostScript is performed to +produce a bitmapped image that can be included. The default is to +produce an image with transparent background, at the same size as the +DVI page currently being converted to PNG, and include that as +foreground on the PNG. Of course, if the image is to be cropped, that +is done. The included image will be a truecolor image, so for maximum +performance the output PNG will be in truecolor mode as well. + + This conversion needs the `pngalpha' output device to be present in +your copy of GhostScript. If that device is not present, or you use the +`--palette' switch or request GIF output, the fallback is to use the +`png16m' device to produce a cropped opaque image for inclusion. Other +relevant switches are `--noghostscript' and `--nogssafer'. *Note Option +details::. -512 - T1lib calls + 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 `\includegraphics' call, as in this example +(using `graphicx'): -1024 - Kpathsea `stat' calls + \includegraphics[bb=10 20 100 200]{imagename.eps} -2048 - Kpathsea hash table lookups - -4096 - Kpathsea path element expansion + +File: dvipng.info, Node: Bitmapped graphics, Prev: Encapsulated PostScript, Up: Graphics -8192 - Kpathsea path searches +5.2 Bitmapped graphics +====================== +dvipng can include PNG, JPEG and GIF graphics. When including such +images via `\includegraphics' you need to specify the bounding box +since TeX itself cannot read them from the files in question. The +bounding box size should be given as `0 0 w h' in pixels, e.g., if the +file `imagename.png' is 300x400 pixels, the inclusion would read - -File: dvipng.info, Node: Included graphics problems, Prev: Debug options, Up: Diagnosing problems + \includegraphics[bb=0 0 300 400]{imagename.png} -5.2 Included graphics problems -============================== + The default size is the image size in bp ("big points" in TeX +nomenclature or PostScript points as other people have it, 72 per inch). +That is, default resolution will be 72 dpi for included bitmaps, which +is the default size in the few other bitmap-capable drivers that are +known to me (dvipdfm and PDFLaTeX). -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. + If you want 100 dpi you need to specify the width accordingly. You +just divide your image width by 100: a 135 pixel wide image at 100 dpi +will take up 1.35 inches. If you want 200 dpi you divide by 200, and so +on. Simple, eh? The example above at 200 dpi would be 1.5 inches wide: - An additional problem is that the image in dvipng is always clipped -to the bounding box. This is because the image is rendered by -GhostScript by an internal call and then copied to the dvipng image. At -present no workaround is known, but there may be one for a future -GhostScript. We'll see. + \includegraphics[bb=0 0 300 400,witdh=1.5in]{imagename.png} -File: dvipng.info, Node: Color, Next: Copying, Prev: Diagnosing problems, Up: Top +File: dvipng.info, Node: Color, Next: Diagnosing problems, Prev: Graphics, Up: Top 6 Color ******* @@ -780,17 +770,18 @@ by-value spec starts with the name of a color model (one of `rgb', `hsb', `cmy', `cmyk', or `gray') followed by the appropriate number of parameters. Thus, the color specification `rgb 0.3 0.4 0.5' would correspond to the color that is `0.3 0.4 0.5' in its red, blue and -green values. The color used internally in dvipng is `RGB' (discretized -to 256 levels), for details on the formulas used in conversion, see the -`xcolor' documentation. +green values. The color model used internally in dvipng is `RGB' +(discretized to 256 levels), for details on the formulas used in +conversion, see the `xcolor' documentation. By-name color specifications are single (case-dependent) words and are compared with color names defined in `dvipsnam.def' (from the `graphics' bundle), `svgnam.def' and `xcolor.sty' (from the `xcolor' -bundle). +bundle). See the `xcolor' documentation for a list of names and the +corresponding colors. - On the command-line, the name `Transparent' can also be used in as -an argument to `--bg' to choose transparent background. *Note Option + On the command-line, the name `Transparent' can also be used as an +argument to `--bg' to choose transparent background. *Note Option details::. @@ -817,8 +808,8 @@ This saves the current color on the color stack and sets the color to be that given by the color specification. This is the most common way to set a color. - The final version of the `color' special is just `color pop', with -no color specification; this says to pop the color last pushed on the + The final form of the `color' special is just `color pop', with no +color specification; this says to pop the color last pushed on the color stack from the color stack and set the current color to be that color. @@ -826,9 +817,105 @@ color. the pages are rendered repeatedly or in reverse order. -File: dvipng.info, Node: Credits, Next: Index, Prev: Copying, Up: Top +File: dvipng.info, Node: Diagnosing problems, Next: Credits, Prev: Color, Up: Top + +7 Diagnosing problems +********************* + +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 +yourself in such a situation. + +* Menu: + +* Contact information:: Who to ask. +* Debug options:: Getting diagnostics. + + +File: dvipng.info, Node: Contact information, Next: Debug options, Up: Diagnosing problems + +7.1 Contact information +======================= + +Bug reports should be sent to <dvipng@nongnu.org>. + + Questions, suggestions for new features, pleas for help, and/or +praise should go to <dvipng@nongnu.org>. For more information on this +mailing list, send a message with just the word `help' as subject or +body to <dvipng-request@nongnu.org> or look at +`http://lists.nongnu.org/mailman/listinfo/dvipng'. + + Offers to support further development will be appreciated. For +developer access, ask on <dvipng@nongnu.org>. + + For details on the TeX path-searching library, and `mktexpk' +problems, *note Common problems: (kpathsea)Common problems. + + +File: dvipng.info, Node: Debug options, Prev: Contact information, Up: Diagnosing problems + +7.2 Debug options +================= + +The `-d' flag to dvipng helps in tracking down certain errors. The +parameter to this flag is an integer that tells what errors are +currently being tracked. To track a certain class of debug messages, +simply provide the appropriate number given below; if you wish to track +multiple classes, sum the numbers of the classes you wish to track. To +track all classes, you can use `-1'. + + Some of these debugging options are actually provided by Kpathsea +(*note Debugging: (kpathsea)Debugging.). + + The classes are: +1 + Normal dvi op-codes -7 Credits +2 + Virtual fonts + +4 + PK fonts + +8 + TFM files + +16 + Glyph rendering + +32 + FreeType calls + +64 + Encoding loads + +128 + Color specials + +256 + GhostScript specials + +512 + T1lib calls + +1024 + Kpathsea `stat' calls + +2048 + Kpathsea hash table lookups + +4096 + Kpathsea path element expansion + +8192 + Kpathsea path searches + + + +File: dvipng.info, Node: Credits, Next: Copying, Prev: Diagnosing problems, Up: Top + +8 Credits ********* A number of persons have contributed, if I forget to mention someone, I @@ -839,17 +926,18 @@ 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), Alan Shutko, Reiner Stieb, Nick Alcock, Adam Buchbinder, +(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 Ridderstro"m, Ezra Peisach, William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin -Smith, and Jason Riedy. +Smith, Jason Riedy, Wolfram Krause, and Reinhard Kotucha. -File: dvipng.info, Node: Copying, Next: Credits, Prev: Color, Up: Top +File: dvipng.info, Node: Copying, Next: Index, Prev: Credits, Up: Top -8 Copying +9 Copying ********* This program is free software; you can redistribute it and/or modify it @@ -864,14 +952,14 @@ General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, -Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. -Copyright (C) 2002-2005 Jan-AAke Larsson +Copyright (C) 2002-2006 Jan-AAke Larsson -File: dvipng.info, Node: Index, Prev: Credits, Up: Top +File: dvipng.info, Node: Index, Prev: Copying, Up: Top Index ***** @@ -879,10 +967,10 @@ Index * Menu: -* -dSAFER: Option details. (line 164) -* absolute page number, and -l: Option details. (line 137) -* absolute page number, and -p: Option details. (line 185) -* antialiasing levels, number of: Option details. (line 229) +* -dSAFER: Option details. (line 166) +* absolute page number, and -l: Option details. (line 139) +* absolute page number, and -p: Option details. (line 187) +* antialiasing levels, number of: Option details. (line 241) * background color (option): Option details. (line 40) * base resolution, setting: Option details. (line 35) * baseline reporting: Option details. (line 76) @@ -891,87 +979,90 @@ Index * command-line options: Command-line options. (line 6) * compilation: Installation. (line 6) -* compression: Option details. (line 284) +* compression: Option details. (line 302) * configuration, of dvipng: Installation. (line 6) -* dark fonts: Option details. (line 118) +* dark fonts: Option details. (line 119) * debugging <1>: Diagnosing problems. (line 6) * debugging: Option details. (line 54) -* debugging options: Debug options. (line 6) * depth reporting: Option details. (line 76) -* first page printed: Option details. (line 185) +* exit on erroneous images: Option details. (line 252) +* first page printed: Option details. (line 187) * follow mode: Option details. (line 97) -* font generation, avoiding: Option details. (line 154) +* font generation, avoiding: Option details. (line 156) +* forcing palette output: Option details. (line 196) * foreground color (option): Option details. (line 91) -* FreeType font rendering: Option details. (line 104) -* fuzzy images: Option details. (line 118) -* gamma: Option details. (line 118) -* GhostScript and -dSAFER: Option details. (line 164) -* GhostScript, turning off: Option details. (line 159) -* GIF image format: Option details. (line 124) -* graphics inclusion problems: Included graphics problems. - (line 6) -* height reporting: Option details. (line 130) +* FreeType font rendering: Option details. (line 105) +* fuzzy images: Option details. (line 119) +* gamma: Option details. (line 119) +* GhostScript and -dSAFER: Option details. (line 166) +* GhostScript, turning off: Option details. (line 161) +* GIF image format: Option details. (line 125) +* height reporting: Option details. (line 132) * installation, of dvipng: Installation. (line 6) * invoking dvipng: Basic usage. (line 6) -* last page printed: Option details. (line 137) -* light fonts: Option details. (line 118) -* magnification, overriding DVI: Option details. (line 276) -* Metafont mode, specifying: Option details. (line 146) -* mktexpk, avoiding: Option details. (line 154) -* mode name, specifying: Option details. (line 146) -* no erroneous images: Option details. (line 194) -* offset pages: Option details. (line 179) +* last page printed: Option details. (line 139) +* light fonts: Option details. (line 119) +* magnification, overriding DVI: Option details. (line 294) +* Metafont mode, specifying: Option details. (line 148) +* mktexpk, avoiding: Option details. (line 156) +* mode name, specifying: Option details. (line 148) +* no erroneous images: Option details. (line 206) +* offset pages: Option details. (line 181) * option, details of: Option details. (line 6) -* options, debugging: Debug options. (line 6) * options, dvipng: Command-line options. (line 6) * options, reading from standard input: Option details. (line 11) * options, summary: Option summary. (line 6) * output resolution, setting: Option details. (line 60) -* output, redirecting: Option details. (line 172) -* page range: Option details. (line 207) -* page, first printed: Option details. (line 185) -* page, last printed: Option details. (line 137) -* physical page number, and -l: Option details. (line 137) -* physical page number, and -p: Option details. (line 185) -* PNG image format: Option details. (line 203) +* output, redirecting: Option details. (line 174) +* page range: Option details. (line 219) +* page, first printed: Option details. (line 187) +* page, last printed: Option details. (line 139) +* physical page number, and -l: Option details. (line 139) +* physical page number, and -p: Option details. (line 187) +* PNG image format: Option details. (line 215) +* PostScript inclusion problems: Encapsulated PostScript. + (line 21) * problems: Diagnosing problems. (line 6) -* quality: Option details. (line 229) -* quiet operation: Option details. (line 225) -* reverse pagination: Option details. (line 236) -* silent operation: Option details. (line 225) +* quality: Option details. (line 241) +* quiet operation: Option details. (line 237) +* reverse pagination: Option details. (line 248) +* silent operation: Option details. (line 237) * standard input, reading options from: Option details. (line 11) -* standard output, output to: Option details. (line 172) -* T1lib font rendering: Option details. (line 251) +* standard output, output to: Option details. (line 174) +* T1lib font rendering: Option details. (line 269) * transparent border fallback color: Option details. (line 25) * transparent border width: Option details. (line 25) * trouble: Diagnosing problems. (line 6) -* truecolor output: Option details. (line 265) -* warnings, suppressing: Option details. (line 225) +* truecolor output: Option details. (line 283) +* warnings, suppressing: Option details. (line 237) Tag Table: -Node: Top296 -Node: Introduction1115 -Node: Installation3107 -Node: Prerequisites3454 -Node: Configure5337 -Node: Build/install7403 -Node: Installation outside the texmf tree7874 -Node: Advice for non-privileged users8581 -Node: Basic usage9574 -Node: Command-line options10701 -Node: Option summary11136 -Node: Option details13559 -Node: Diagnosing problems27947 -Node: Debug options29059 -Node: Included graphics problems30101 -Node: Color30749 -Node: Color specifications31083 -Node: Color specials32098 -Node: Credits33513 -Node: Copying34542 -Node: Index35369 +Node: Top317 +Node: Introduction1204 +Node: Installation3185 +Node: Prerequisites3532 +Node: Configure5914 +Node: Build/install7953 +Node: Installation outside the texmf tree8421 +Node: Advice for non-privileged users9128 +Node: Basic usage10136 +Node: Command-line options11263 +Node: Option summary11687 +Node: Option details13807 +Node: Graphics29131 +Node: Encapsulated PostScript29696 +Node: Bitmapped graphics31039 +Node: Color32239 +Node: Color specifications32574 +Node: Color specials33673 +Node: Diagnosing problems35085 +Node: Contact information35568 +Node: Debug options36309 +Node: Credits37344 +Node: Copying38493 +Node: Index39322 End Tag Table diff --git a/Master/texmf/doc/info/dvips.info b/Master/texmf/doc/info/dvips.info index 6f7348095fb..adfde7a1831 100644 --- a/Master/texmf/doc/info/dvips.info +++ b/Master/texmf/doc/info/dvips.info @@ -1,7 +1,8 @@ This is dvips.info, produced by makeinfo version 4.8 from dvips.texi. - This manual documents Dvips version 5.95b (August 2005), a program -to translate a DVI file into PostScript. + This manual documents Dvips version 5.96 (January 2007), a program +to translate a DVI file into PostScript. You may freely use, modify +and/or distribute this file. INFO-DIR-SECTION TeX START-INFO-DIR-ENTRY @@ -16,8 +17,9 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir) Dvips ***** -This manual documents Dvips version 5.95b (August 2005), a program to -translate a DVI file into PostScript. +This manual documents Dvips version 5.96 (January 2007), a program to +translate a DVI file into PostScript. You may freely use, modify +and/or distribute this file. * Menu: @@ -141,7 +143,7 @@ Since these are site-specific, `make install' does not create them; you must create them yourself. (These Dvips configuration files are independent of the Kpathsea -onfiguration file `texmf.cnf' (*note Config files: (kpathsea)Config +configuration file `texmf.cnf' (*note Config files: (kpathsea)Config files.). Dvips configuration files contents and searching are described fully @@ -810,9 +812,10 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. Bugs: (kpathsea)Bugs.). `-o NAME' - Send output to the file NAME. If `-o' is specified without NAME, - the default is `FILE.ps' where the input DVI file was `FILE.dvi'. - If `-o' isn't given at all, the configuration file default is used. + Send output to the file NAME. If `-o' is specified without NAME + (i.e., it is the last thing on the command line), the default is + `FILE.ps' where the input DVI file was `FILE.dvi'. If `-o' isn't + given at all, the configuration file default is used. If NAME is `-', output goes to standard output. If the first character of NAME is `!' or `|', then the remainder will be used @@ -884,10 +887,12 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. Output pages in reverse order. By default, page 1 is output first. `-R' - Run securely. This disables shell command execution in `\special' - (via ``', *note Dynamic creation of graphics::) and config files - (via the `E' option, *note Configuration file commands::), and - opening of any absolute filenames. + Run securely. `-R2' disables both shell command execution in + `\special' (via ``', *note Dynamic creation of graphics::) and + config files (via the `E' option, *note Configuration file + commands::) and opening of any absolute filenames. `-R1', the + default, forbids shell escapes but allows absolute filenames. + `-R0' allows both. `-s*' Enclose the output in a global save/restore pair. This causes the @@ -915,7 +920,9 @@ reversal, use `-r0'. Such options are marked with a trailing `*'. `-T HSIZE,VSIZE' Set the paper size to (HSIZE,VSIZE), a comma-separated pair of dimensions such as `.1in,-.3cm' (*note papersize special::). It - overrides any paper size special in the DVI file. + overrides any paper size special in the DVI file. Be careful, as + the paper size will stick to a predefined size if there is one + close enough. To disable this behavior, use `-tunknown'. `-u PSMAPFILE' Set PSMAPFILE to be the file that dvips uses for looking up @@ -1313,8 +1320,8 @@ There is no provision for continuation lines. `z*' Disables execution of system commands, like `-R' (*note Option - details::). If `-R1' is given to disable system commands, - however, this will not re-enable them. + details::). If `-R' is specified on the command line, that takes + precedence. @@ -1433,11 +1440,11 @@ For example: When Dvips has a paper format name given on the command line, it looks for a match by the NAME; when it has a `papersize' special, it -looks for a match by dimensions. The first match found (in the order -the paper size information is found in the configuration file) is used. -If nothing matches, a warning is printed and the first paper size is -used. The dimensions must match within a quarter of an inch. Landscape -mode for all paper sizes is automatically supported. +looks for a match by dimensions. The best match found (from the paper +size information in the configuration file) is used. If nothing +matches, a warning is printed and the first paper size is used. The +dimensions must match within 5bp. Landscape mode for all paper sizes +is automatically supported. If your printer has a command to set a special paper size, then give dimensions of `0in 0in'; the PostScript code that sets the paper size @@ -3703,7 +3710,7 @@ Index * Menu: * ! special (literal PS header): Literal headers. (line 6) -* ! starting output filename: Option details. (line 222) +* ! starting output filename: Option details. (line 223) * " special (literal PostScript): " special. (line 6) * %%BoundingBox: Bounding box. (line 17) * %%Page, and multi-page information: PostScript hooks. (line 37) @@ -3718,7 +3725,7 @@ Index * +PSMAPFILE: Configuration file commands. (line 101) * -: Option details. (line 11) -* - as output filename: Option details. (line 222) +* - as output filename: Option details. (line 223) * --help <1>: Option details. (line 15) * --help: Option summary. (line 7) * --version: Option details. (line 18) @@ -3752,43 +3759,43 @@ Index * -noomega: Option details. (line 205) * -O: Afm2tfm options. (line 41) * -o NAME: Option details. (line 218) -* -O X-OFFSET,Y-OFFSET: Option details. (line 234) -* -p [=]NUM: Option details. (line 252) -* -P PRINTER: Option details. (line 266) +* -O X-OFFSET,Y-OFFSET: Option details. (line 235) +* -p [=]NUM: Option details. (line 253) +* -P PRINTER: Option details. (line 267) * -p PS-ENC <1>: Afm2tfm options. (line 46) * -p PS-ENC: Changing PostScript encodings. (line 6) -* -pp FIRST-LAST: Option details. (line 261) -* -pp RANGE: Option details. (line 261) +* -pp FIRST-LAST: Option details. (line 262) +* -pp RANGE: Option details. (line 262) * -PPRINTER, and config file searching: Configuration file searching. (line 27) -* -q: Option details. (line 285) -* -R: Option details. (line 292) -* -r: Option details. (line 289) -* -s: Option details. (line 298) -* -S NUM: Option details. (line 305) +* -q: Option details. (line 286) +* -R: Option details. (line 293) +* -r: Option details. (line 290) +* -s: Option details. (line 301) +* -S NUM: Option details. (line 308) * -s SLANT: Afm2tfm options. (line 51) * -T ENC-FILE: Changing both encodings. (line 6) -* -T HSIZE,VSIZE: Option details. (line 321) -* -t PAPERTYPE: Option details. (line 310) +* -T HSIZE,VSIZE: Option details. (line 324) +* -t PAPERTYPE: Option details. (line 313) * -T PS-TEX-ENC: Afm2tfm options. (line 61) * -t TEX-ENC <1>: Afm2tfm options. (line 56) * -t TEX-ENC: Changing TeX encodings. (line 6) * -u: Afm2tfm options. (line 65) -* -U: Option details. (line 334) -* -u PSMAPFILE: Option details. (line 326) -* -V: Option details. (line 345) -* -v: Option details. (line 342) +* -U: Option details. (line 339) +* -u PSMAPFILE: Option details. (line 331) +* -V: Option details. (line 350) +* -v: Option details. (line 347) * -V VPL-FILE: Afm2tfm options. (line 74) * -v VPL-FILE: Afm2tfm options. (line 71) -* -X NUM: Option details. (line 362) -* -x NUM: Option details. (line 354) -* -Y NUM: Option details. (line 369) +* -X NUM: Option details. (line 367) +* -x NUM: Option details. (line 359) +* -Y NUM: Option details. (line 374) * -z: Hypertext. (line 6) -* -Z for compressing bitmap fonts: Option details. (line 378) -* -z for recognizing hyperdvi: Option details. (line 372) +* -Z for compressing bitmap fonts: Option details. (line 383) +* -z for recognizing hyperdvi: Option details. (line 377) * .afm Adobe metric files: Metric files. (line 26) * .dvipsrc, searched for: Configuration file searching. (line 14) @@ -3843,13 +3850,13 @@ Index (line 21) * A ring, Scandinavian letter: Reencoding with Afm2tfm. (line 32) -* a3 papertype: Option details. (line 310) +* a3 papertype: Option details. (line 313) * a4 paper size, as default: Config file paper sizes. (line 72) -* a4 papertype: Option details. (line 310) -* absolute filenames, disabling: Option details. (line 292) +* a4 papertype: Option details. (line 313) +* absolute filenames, disabling: Option details. (line 293) * absolute page number, and -l: Option details. (line 162) -* absolute page number, and -p: Option details. (line 252) +* absolute page number, and -p: Option details. (line 253) * accents, in wrong position: Reencoding with Afm2tfm. (line 32) * accents, wrong: Afm2tfm options. (line 17) @@ -3892,7 +3899,7 @@ Index * bop undefined error: Printer errors. (line 6) * bop-hook <1>: PostScript hooks. (line 11) * bop-hook: EPSF scaling. (line 75) -* bop-hook, and offset pages: Option details. (line 247) +* bop-hook, and offset pages: Option details. (line 248) * boundary character: Encoding file format. (line 41) * bounding box, comment for: Bounding box. (line 6) @@ -3939,13 +3946,13 @@ Index * compilation: Installation. (line 6) * compressed PostScript: Dynamic creation of graphics. (line 6) -* compressing bitmap fonts: Option details. (line 378) +* compressing bitmap fonts: Option details. (line 383) * Computer Modern in PostScript: Hypertext caveats. (line 6) * Computer Modern, encoding of: Encodings. (line 15) * condensed fonts: Afm2tfm options. (line 37) * config.proto: config.ps installation. (line 15) -* config.ps: Option details. (line 266) +* config.ps: Option details. (line 267) * config.ps installation: config.ps installation. (line 6) * config.ps, searched for: Configuration file searching. @@ -3999,7 +4006,7 @@ Index (line 35) * dictionary, SDict: Literal headers. (line 6) * dictionary, userdict: Header files. (line 21) -* distillation, and -z: Option details. (line 372) +* distillation, and -z: Option details. (line 377) * distiller, for PDF files: Hypertext. (line 11) * dot accent: Reencoding with Afm2tfm. (line 32) @@ -4092,7 +4099,7 @@ Index * figures, natural size: EPSF macros. (line 38) * figures, scaling: EPSF scaling. (line 6) * filter, running as a: Option details. (line 98) -* first page printed: Option details. (line 252) +* first page printed: Option details. (line 253) * font concepts: Font concepts. (line 6) * font generation, avoiding: Option details. (line 183) * fontinst: Invoking afm2tfm. (line 13) @@ -4136,7 +4143,7 @@ Index * gs installation: Ghostscript installation. (line 6) * gsave/grestore, and literal PS: Literal examples. (line 27) -* gsftopk: Option details. (line 346) +* gsftopk: Option details. (line 351) * h header downloading config command: Configuration file commands. (line 44) * H header path config command: Configuration file commands. @@ -4161,12 +4168,12 @@ Index * HP4Si printer and paper trays: Paper trays. (line 6) * href: Hypertext specials. (line 32) * html specials: Hypertext. (line 6) -* html specials, and -z: Option details. (line 372) +* html specials, and -z: Option details. (line 377) * http://www.win.tue.nl/~dickie/idvi: Hypertext. (line 21) * http://xxx.lanl.gov/hypertex: Hypertext. (line 21) * Hungarian umlaut: Reencoding with Afm2tfm. (line 32) -* hyperdvi extensions, enabling: Option details. (line 372) +* hyperdvi extensions, enabling: Option details. (line 377) * hypertext and bitmap fonts: Hypertext caveats. (line 6) * hypertext caveats: Hypertext caveats. (line 6) * hypertext specials: Hypertext specials. (line 6) @@ -4203,16 +4210,16 @@ Index * kerning, defined: Metric files. (line 15) * landscape orientation, defined: Paper size and landscape. (line 11) -* landscape papertype: Option details. (line 310) +* landscape papertype: Option details. (line 313) * landscape, as \special: papersize special. (line 16) * last page printed: Option details. (line 162) * last-resort font scaling, with DVIPSSIZES: Environment variables. (line 38) * last-resort scaling, with R: Configuration file commands. (line 123) -* ledger papertype: Option details. (line 310) -* legal papertype: Option details. (line 310) -* letter papertype: Option details. (line 310) +* ledger papertype: Option details. (line 313) +* legal papertype: Option details. (line 313) +* letter papertype: Option details. (line 313) * letterhead tray: Paper trays. (line 10) * ligature operations: Encoding file format. (line 54) @@ -4226,7 +4233,7 @@ Index * literal PostScript, using: Literal PS. (line 6) * long documents not printing: Long documents fail. (line 6) * low characters, shifting: Option details. (line 117) -* lpr spooler, MS-DOS emulation: Option details. (line 222) +* lpr spooler, MS-DOS emulation: Option details. (line 223) * Lucida, installing: PostScript font installation. (line 10) * m config command (available memory): Configuration file commands. @@ -4237,13 +4244,13 @@ Index * macros for epsf inclusion <1>: EPSF macros. (line 6) * macros for epsf inclusion: \includegraphics. (line 6) * magnification, DVI: EPSF scaling. (line 63) -* magnification, overriding DVI: Option details. (line 354) -* magnification, vertical: Option details. (line 365) +* magnification, overriding DVI: Option details. (line 359) +* magnification, vertical: Option details. (line 370) * mailcap and hypertext: Hypertext specials. (line 53) * manual feed: Option details. (line 171) * maxdrift: Option details. (line 71) * maximum pages printed: Option details. (line 194) -* media: Option details. (line 310) +* media: Option details. (line 313) * memory available: Configuration file commands. (line 63) * memory of printer exhausted: Printer errors. (line 14) @@ -4271,7 +4278,7 @@ Index (line 10) * Monotype fonts, installing: PostScript font installation. (line 19) -* mtpk: Option details. (line 346) +* mtpk: Option details. (line 351) * multiple master fonts: psfonts.map. (line 27) * multiple output files: Option details. (line 126) * multiple paper trays: Paper trays. (line 6) @@ -4291,7 +4298,7 @@ Index (line 6) * octal character codes: Afm2tfm options. (line 41) * odd pages only: Option details. (line 27) -* offset pages: Option details. (line 234) +* offset pages: Option details. (line 235) * Omega extensions: Option details. (line 205) * option, details of: Option details. (line 6) * options, debugging: Debug options. (line 6) @@ -4315,8 +4322,8 @@ Index (line 101) * P config command (PK path): Configuration file commands. (line 110) -* page range: Option details. (line 261) -* page, first printed: Option details. (line 252) +* page range: Option details. (line 262) +* page, first printed: Option details. (line 253) * page, last printed: Option details. (line 162) * pages, maximum printed: Option details. (line 194) * PaintType: Special font effects. @@ -4329,15 +4336,15 @@ Index * paper size, general: Paper size and landscape. (line 6) * paper trays: Paper trays. (line 6) -* paper type: Option details. (line 310) +* paper type: Option details. (line 313) * papersize special: papersize special. (line 6) -* papersize special, and no -t: Option details. (line 310) +* papersize special, and no -t: Option details. (line 313) * partial font downloading: psfonts.map. (line 17) * PDF files, font quality: Hypertext caveats. (line 6) * PDF files, making <1>: Hypertext. (line 11) * PDF files, making: Ghostscript installation. (line 6) -* PDF files, option for: Option details. (line 372) +* PDF files, option for: Option details. (line 377) * pdfmark: Hypertext. (line 6) * pfa files: Glyph files. (line 25) * pfb files: Glyph files. (line 25) @@ -4346,7 +4353,7 @@ Index * Phaser printer, used for color calibration: Color device configuration. (line 18) * physical page number, and -l: Option details. (line 162) -* physical page number, and -p: Option details. (line 252) +* physical page number, and -p: Option details. (line 253) * physical page number, and bop-hook: PostScript hooks. (line 26) * pipes, not readable: Option details. (line 98) * pk files: Glyph files. (line 35) @@ -4354,7 +4361,7 @@ Index (line 110) * plotfile, ps subspecial: ps special. (line 25) * pltotf: Metric files. (line 39) -* popen for output: Option details. (line 222) +* popen for output: Option details. (line 223) * positioning accuracy: Option details. (line 71) * post code after headers: Including headers from TeX. (line 28) @@ -4364,7 +4371,7 @@ Index (line 6) * PostScript font alias file <1>: Configuration file commands. (line 101) -* PostScript font alias file: Option details. (line 326) +* PostScript font alias file: Option details. (line 331) * PostScript fonts: PostScript fonts. (line 6) * PostScript fonts, installing: PostScript font installation. (line 6) @@ -4392,7 +4399,7 @@ Index * printer memory: Configuration file commands. (line 63) * printer memory exhausted: Printer errors. (line 14) -* printer offset: Option details. (line 234) +* printer offset: Option details. (line 235) * PRINTER, and config file searching: Configuration file searching. (line 36) * PRINTER, avoided with -f: Option details. (line 98) @@ -4410,12 +4417,12 @@ Index (line 24) * psheaderdir: Header files. (line 12) * psi character missing: Hypertext caveats. (line 55) -* pstopk: Option details. (line 346) +* pstopk: Option details. (line 351) * Q config command (quiet): Configuration file commands. (line 117) * q config command (quiet): Configuration file commands. (line 117) -* quiet operation: Option details. (line 285) +* quiet operation: Option details. (line 286) * r config command (page reversal): Configuration file commands. (line 120) * R fallback resolution config command: Configuration file commands. @@ -4431,10 +4438,10 @@ Index * resident fonts, different in different printers <1>: Configuration file commands. (line 101) * resident fonts, different in different printers: Option details. - (line 326) -* resolution: Option details. (line 362) + (line 331) +* resolution: Option details. (line 367) * resolution, setting: Option details. (line 58) -* reverse pagination: Option details. (line 289) +* reverse pagination: Option details. (line 290) * Rokicki, Tomas: Why Dvips. (line 68) * rotate.tex: ps special. (line 29) * S config command (pict path): Configuration file commands. @@ -4444,7 +4451,7 @@ Index * save/restore, and inverted output: Small or inverted. (line 6) * save/restore, and literal PS: Literal examples. (line 27) * save/restore, and specials: ps special. (line 6) -* save/restore, generating global: Option details. (line 298) +* save/restore, generating global: Option details. (line 301) * scaleunit: psfile special. (line 55) * scaling of figures: EPSF scaling. (line 6) * scaling small caps: Afm2tfm options. (line 33) @@ -4459,14 +4466,14 @@ Index * sections of output file, and memory: Headers and memory usage. (line 6) * sections output, in separate files: Option details. (line 126) -* security: Option details. (line 292) -* shell command execution, disabling: Option details. (line 292) +* security: Option details. (line 293) +* shell command execution, disabling: Option details. (line 293) * shell escape, in config file: Configuration file commands. (line 33) * Shinko CHC-S446i printer: No output. (line 14) * show PostScript operator: PostScript typesetting. (line 23) -* silent operation: Option details. (line 285) +* silent operation: Option details. (line 286) * simplex mode on duplex printers: Including headers from the command line. (line 13) * slanted fonts: Special font effects. @@ -4485,7 +4492,7 @@ Index * specials, hypertext: Hypertext specials. (line 6) * splines: Glyph files. (line 17) * spooler, lacking: Option details. (line 110) -* spooling to lpr on MS-DOS: Option details. (line 222) +* spooling to lpr on MS-DOS: Option details. (line 223) * standard I/O: Option details. (line 98) * standard input, reading options from: Option details. (line 11) * standard output, output to: Option details. (line 218) @@ -4499,7 +4506,7 @@ Index (line 153) * Tektronix Phaser printer, used for color calibration: Color device configuration. (line 18) -* testpage.tex: Option details. (line 241) +* testpage.tex: Option details. (line 242) * TeX encoding, changing: Changing TeX encodings. (line 6) * TeX, including headers in: Including headers from TeX. @@ -4575,12 +4582,12 @@ Index (line 167) * warning messages, defining: Configuration file commands. (line 167) -* warnings, suppressing: Option details. (line 285) +* warnings, suppressing: Option details. (line 286) * whole font downloading: psfonts.map. (line 27) * wide fonts: psfonts.map. (line 32) * X config command (horizontal resolution): Configuration file commands. (line 174) -* Xerox 4045: Option details. (line 334) +* Xerox 4045: Option details. (line 339) * Y config command (vertical resolution): Configuration file commands. (line 177) * Y&Y fonts, installing: PostScript font installation. @@ -4589,87 +4596,87 @@ Index (line 180) * z config command (secure mode): Configuration file commands. (line 183) -* | starting output filename: Option details. (line 222) +* | starting output filename: Option details. (line 223) Tag Table: -Node: Top465 -Node: Why Dvips1155 -Node: Installation4603 -Node: config.ps installation5741 -Node: PostScript font installation8282 -Node: Ghostscript installation11156 -Node: Diagnosing problems12253 -Node: Debug options13122 -Node: No output14238 -Node: Small or inverted15706 -Node: Printer errors16425 -Node: Long documents fail17757 -Node: Including graphics fails18098 -Node: Invoking Dvips19336 -Node: Basic usage19927 -Node: Command-line options20911 -Node: Option summary21360 -Node: Option details23336 -Node: Environment variables41418 -Node: Config files43921 -Node: Configuration file searching44604 -Node: Configuration file commands47904 -Node: Paper size and landscape54941 -Node: papersize special56518 -Node: Config file paper sizes57632 -Node: Paper trays61765 -Node: Interaction with PostScript63099 -Node: PostScript figures63752 -Node: Bounding box64478 -Node: \includegraphics67849 -Node: EPSF macros70140 -Node: EPSF scaling72110 -Node: EPSF clipping74680 -Node: psfile special75322 -Node: Dynamic creation of graphics77242 -Node: Fonts in figures78560 -Node: Header files80220 -Node: Including headers from TeX81426 -Node: Including headers from the command line83460 -Node: Headers and memory usage84560 -Node: Literal PS85270 -Node: " special85852 -Node: ps special86593 -Node: Literal headers87901 -Node: PostScript hooks88616 -Node: Literal examples90706 -Node: Hypertext92158 -Node: Hypertext caveats93716 -Node: Hypertext specials98113 -Node: PostScript fonts100747 -Node: Font concepts101863 -Node: Metric files103030 -Node: Glyph files105856 -Node: Virtual fonts108212 -Node: Encodings110102 -Node: PostScript typesetting112484 -Node: Making a font available115566 -Node: Invoking afm2tfm120596 -Node: Changing font encodings121566 -Node: Changing TeX encodings122357 -Node: Changing PostScript encodings123457 -Node: Changing both encodings124801 -Node: Reencoding with Afm2tfm125474 -Node: Encoding file format128578 -Node: Special font effects132781 -Node: Afm2tfm options135044 -Node: psfonts.map138029 -Node: Color142753 -Node: Color macro files143797 -Node: User-definable colors146995 -Node: Color subtleties148270 -Node: Ted Turner149921 -Node: Color device configuration151146 -Node: Color support details153588 -Node: Color specifications153966 -Node: Color specials155369 -Node: Index157498 +Node: Top522 +Node: Why Dvips1269 +Node: Installation4717 +Node: config.ps installation5855 +Node: PostScript font installation8397 +Node: Ghostscript installation11271 +Node: Diagnosing problems12368 +Node: Debug options13237 +Node: No output14353 +Node: Small or inverted15821 +Node: Printer errors16540 +Node: Long documents fail17872 +Node: Including graphics fails18213 +Node: Invoking Dvips19451 +Node: Basic usage20042 +Node: Command-line options21026 +Node: Option summary21475 +Node: Option details23451 +Node: Environment variables41842 +Node: Config files44345 +Node: Configuration file searching45028 +Node: Configuration file commands48328 +Node: Paper size and landscape55345 +Node: papersize special56922 +Node: Config file paper sizes58036 +Node: Paper trays62135 +Node: Interaction with PostScript63469 +Node: PostScript figures64122 +Node: Bounding box64848 +Node: \includegraphics68219 +Node: EPSF macros70510 +Node: EPSF scaling72480 +Node: EPSF clipping75050 +Node: psfile special75692 +Node: Dynamic creation of graphics77612 +Node: Fonts in figures78930 +Node: Header files80590 +Node: Including headers from TeX81796 +Node: Including headers from the command line83830 +Node: Headers and memory usage84930 +Node: Literal PS85640 +Node: " special86222 +Node: ps special86963 +Node: Literal headers88271 +Node: PostScript hooks88986 +Node: Literal examples91076 +Node: Hypertext92528 +Node: Hypertext caveats94086 +Node: Hypertext specials98483 +Node: PostScript fonts101117 +Node: Font concepts102233 +Node: Metric files103400 +Node: Glyph files106226 +Node: Virtual fonts108582 +Node: Encodings110472 +Node: PostScript typesetting112854 +Node: Making a font available115936 +Node: Invoking afm2tfm120966 +Node: Changing font encodings121936 +Node: Changing TeX encodings122727 +Node: Changing PostScript encodings123827 +Node: Changing both encodings125171 +Node: Reencoding with Afm2tfm125844 +Node: Encoding file format128948 +Node: Special font effects133151 +Node: Afm2tfm options135414 +Node: psfonts.map138399 +Node: Color143123 +Node: Color macro files144167 +Node: User-definable colors147365 +Node: Color subtleties148640 +Node: Ted Turner150291 +Node: Color device configuration151516 +Node: Color support details153958 +Node: Color specifications154336 +Node: Color specials155739 +Node: Index157868 End Tag Table diff --git a/Master/texmf/doc/info/kpathsea.info b/Master/texmf/doc/info/kpathsea.info index 3719f12a44f..11b984ebd45 100644 --- a/Master/texmf/doc/info/kpathsea.info +++ b/Master/texmf/doc/info/kpathsea.info @@ -14,7 +14,8 @@ END-INFO-DIR-ENTRY This file documents the Kpathsea library for path searching. - Copyright (C) 1993-2005 Karl Berry & Olaf Weber. + Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, +2005, 2007 Karl Berry & Olaf Weber. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -37,8 +38,8 @@ Kpathsea library **************** This manual documents how to install and use the Kpathsea library for -filename lookup. It corresponds to version 3.5.5, released in -June 2005. +filename lookup. It corresponds to version 3.5.6, released in +January 2007. * Menu: @@ -58,8 +59,8 @@ File: kpathsea.info, Node: Introduction, Next: Installation, Prev: Top, Up: 1 Introduction ************** -This manual corresponds to version 3.5.5 of the Kpathsea library, -released in June 2005. +This manual corresponds to version 3.5.6 of the Kpathsea library, +released in January 2007. The library's fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do @@ -4563,85 +4564,85 @@ Index Tag Table: -Node: Top1413 -Node: Introduction2056 -Node: History4032 -Node: Installation8124 -Node: Simple installation8914 -Node: Custom installation12497 -Node: Disk space13671 -Node: Kpathsea application distributions14555 -Node: Changing search paths15670 -Node: Default path features16852 -Node: Default path generation18988 -Node: Running configure20431 -Node: configure shells21482 -Node: configure options22534 -Node: configure environment24041 -Node: configure scenarios25843 -Node: Shared library27429 -Node: Running make28763 -Node: Installing files30810 -Node: Cleaning up32757 -Node: Filename database generation33805 -Node: mktex scripts34372 -Node: mktex configuration35329 -Node: mktex script names40873 -Node: mktex script arguments41971 -Node: Installation testing42861 -Node: Security43225 -Node: TeX directory structure45792 -Node: unixtex.ftp50214 -Node: Electronic distribution52229 -Node: CD-ROM distribution54994 -Node: Other TeX packages55964 -Node: Reporting bugs57260 -Node: Bug checklist58000 -Node: Mailing lists62101 -Node: Debugging63460 -Node: Logging68532 -Node: Common problems70043 -Node: Unable to find files70874 -Node: Slow path searching73285 -Node: Unable to generate fonts74662 -Node: TeX or Metafont failing77171 -Node: Empty Makefiles79049 -Node: XtStrings80279 -Node: dlopen81115 -Node: ShellWidgetClass81933 -Node: Pointer combination warnings83565 -Node: Path searching83954 -Node: Searching overview84601 -Node: Path sources87973 -Node: Config files89044 -Node: Path expansion92444 -Node: Default expansion93393 -Node: Variable expansion95463 -Node: Tilde expansion96866 -Node: Brace expansion97764 -Node: KPSE_DOT expansion98869 -Node: Subdirectory expansion99382 -Node: Filename database101731 -Node: ls-R103045 -Node: Filename aliases105939 -Node: Database format107117 -Node: Invoking kpsewhich108130 -Node: Path searching options109007 -Node: Auxiliary tasks113144 -Node: Standard options114652 -Node: TeX support114972 -Node: Supported file formats116263 -Node: File lookup123411 -Node: Glyph lookup124702 -Node: Basic glyph lookup125829 -Node: Fontmap126708 -Node: Fallback font129325 -Node: Suppressing warnings130290 -Node: Programming131395 -Node: Programming overview131908 -Node: Calling sequence134184 -Node: Program-specific files139213 -Node: Programming with config files140251 -Node: Index141551 +Node: Top1468 +Node: Introduction2114 +Node: History4093 +Node: Installation8185 +Node: Simple installation8975 +Node: Custom installation12558 +Node: Disk space13732 +Node: Kpathsea application distributions14616 +Node: Changing search paths15731 +Node: Default path features16913 +Node: Default path generation19049 +Node: Running configure20492 +Node: configure shells21543 +Node: configure options22595 +Node: configure environment24102 +Node: configure scenarios25904 +Node: Shared library27490 +Node: Running make28824 +Node: Installing files30871 +Node: Cleaning up32818 +Node: Filename database generation33866 +Node: mktex scripts34433 +Node: mktex configuration35390 +Node: mktex script names40934 +Node: mktex script arguments42032 +Node: Installation testing42922 +Node: Security43286 +Node: TeX directory structure45853 +Node: unixtex.ftp50275 +Node: Electronic distribution52290 +Node: CD-ROM distribution55055 +Node: Other TeX packages56025 +Node: Reporting bugs57321 +Node: Bug checklist58061 +Node: Mailing lists62162 +Node: Debugging63521 +Node: Logging68593 +Node: Common problems70104 +Node: Unable to find files70935 +Node: Slow path searching73346 +Node: Unable to generate fonts74723 +Node: TeX or Metafont failing77232 +Node: Empty Makefiles79110 +Node: XtStrings80340 +Node: dlopen81176 +Node: ShellWidgetClass81994 +Node: Pointer combination warnings83626 +Node: Path searching84015 +Node: Searching overview84662 +Node: Path sources88034 +Node: Config files89105 +Node: Path expansion92505 +Node: Default expansion93454 +Node: Variable expansion95524 +Node: Tilde expansion96927 +Node: Brace expansion97825 +Node: KPSE_DOT expansion98930 +Node: Subdirectory expansion99443 +Node: Filename database101792 +Node: ls-R103106 +Node: Filename aliases106000 +Node: Database format107178 +Node: Invoking kpsewhich108191 +Node: Path searching options109068 +Node: Auxiliary tasks113205 +Node: Standard options114713 +Node: TeX support115033 +Node: Supported file formats116324 +Node: File lookup123472 +Node: Glyph lookup124763 +Node: Basic glyph lookup125890 +Node: Fontmap126769 +Node: Fallback font129386 +Node: Suppressing warnings130351 +Node: Programming131456 +Node: Programming overview131969 +Node: Calling sequence134245 +Node: Program-specific files139274 +Node: Programming with config files140312 +Node: Index141612 End Tag Table diff --git a/Master/texmf/doc/info/web2c.info b/Master/texmf/doc/info/web2c.info index 2742d1abb9d..813482e96b5 100644 --- a/Master/texmf/doc/info/web2c.info +++ b/Master/texmf/doc/info/web2c.info @@ -34,8 +34,8 @@ END-INFO-DIR-ENTRY This file documents the installation and use of the programs in Web2c, an implementation of Donald Knuth's TeX system. - Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 -Karl Berry & Olaf Weber. + Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, +2005, 2007 Karl Berry & Olaf Weber. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -59,7 +59,7 @@ Web2c This document describes how to install and use the programs in the Web2c implementation of the TeX system, especially for Unix systems. It -corresponds to Web2c version 7.5.5, released in June 2005. +corresponds to Web2c version 7.5.6, released in January 2007. * Menu: @@ -83,8 +83,8 @@ File: web2c.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top 1 Introduction ************** -This manual corresponds to version 7.5.5 of Web2c, released in -June 2005. +This manual corresponds to version 7.5.6 of Web2c, released in +January 2007. "Web2c" is the name of a TeX implementation, originally for Unix, but now also running under DOS, Amiga, and other operating systems. By @@ -2216,9 +2216,11 @@ environment variables. Here is a list: Likewise, for Troff; default is `dmp'. `TEX' - The command run to typeset the labels in TeX; default is `tex'. - If you use LaTeX, set this to `latex', and supply an appropriate - `verbatimtex' header in the MP source (*note mpost invocation::). + The command run to typeset the labels in TeX; the default is + `etex', set in `texmf.cnf'. If you use LaTeX, set this to + `latex', and supply an appropriate `verbatimtex' header in the MP + source (*note mpost invocation::). Or put `%&latex' as the first + line of your LaTeX source. `TROFF' Likewise, for Troff; default is `'eqn -d\$\$ | troff -Tpost''. You @@ -2230,6 +2232,13 @@ environment variables. Here is a list: environment variable or configuration value to point to the appropriate font directory, traditionally `/usr/lib/font/devTERM'. + One more complication is whether the troff programs have a `g' + prefix. On Windows, TeX Live supports both ways: `makempx.exe' is + built to use `gsoelim.exe', `geqn.exe', and `gtroff.exe', while + `makempx-without-g-prefix.exe' is built to use `soelim.exe', + `eqn.exe', and `troff.exe'. MetaPost users on Windows using troff + for their labels should arrange to run the proper binary. + File: web2c.info, Node: dvitomp invocation, Next: dmp invocation, Prev: makempx invocation, Up: MetaPost @@ -4569,7 +4578,7 @@ Index * trip test: Triptrap. (line 6) * tripman.tex: Triptrap. (line 6) * triptrap Make target: Additional targets. (line 41) -* TROFF: makempx invocation. (line 79) +* TROFF: makempx invocation. (line 81) * Troff, and MetaPost: mpost invocation. (line 73) * Troff, WEB for: WEB. (line 14) * Trojan horses and TeX programs: tex invocation. (line 51) @@ -4662,78 +4671,78 @@ Index Tag Table: -Node: Top2967 -Node: Introduction3962 -Node: Installation7139 -Node: configure options9303 -Node: Compile-time options11385 -Node: Additional targets12511 -Node: Triptrap13792 -Node: Runtime options15321 -Node: Commonalities17093 -Node: Option conventions17698 -Node: Common options18922 -Node: Path searching23434 -Node: Output file location24456 -Node: Three programs25496 -Node: Initial and virgin26255 -Node: Memory dumps27355 -Node: Creating memory dumps27822 -Node: Determining the memory dump to use29083 -Node: Hardware and memory dumps30707 -Node: Editor invocation33176 -Node: \input filenames33906 -Node: TeX36899 -Node: tex invocation37989 -Node: Initial TeX45921 -Node: Formats47410 -Node: Languages and hyphenation50349 -Node: MLTeX50777 -Node: \charsubdef52272 -Node: \tracingcharsubdef54598 -Node: TCX files55173 -Node: patgen invocation60597 -Node: IPC and TeX61314 -Node: TeX extensions61915 -Node: Metafont63216 -Node: mf invocation64504 -Node: Initial Metafont68387 -Node: Modes70140 -Node: Online Metafont graphics72395 -Node: gftodvi invocation75668 -Node: mft invocation77927 -Node: MetaPost81982 -Node: mpost invocation83003 -Node: Initial MetaPost88188 -Node: makempx invocation90000 -Node: dvitomp invocation93500 -Node: dmp invocation94129 -Node: mpto invocation98150 -Node: newer invocation99132 -Node: BibTeX100069 -Node: bibtex invocation100430 -Node: Basic BibTeX style files102755 -Node: WEB104097 -Node: tangle invocation105380 -Node: weave invocation107503 -Node: pooltype invocation108911 -Node: DVI utilities110041 -Node: dvicopy invocation110985 -Node: dvitype invocation112283 -Node: dvitype output example114638 -Node: Font utilities117689 -Node: Font file formats118869 -Node: gftopk invocation122168 -Node: pktogf invocation123372 -Node: pktype invocation124551 -Node: gftype invocation127386 -Node: tftopl invocation131902 -Node: pltotf invocation136536 -Node: vftovp invocation137601 -Node: vptovf invocation139885 -Node: Font utilities available elsewhere140939 -Node: Legalisms143359 -Node: References145530 -Node: Index149915 +Node: Top2979 +Node: Introduction3977 +Node: Installation7157 +Node: configure options9321 +Node: Compile-time options11403 +Node: Additional targets12529 +Node: Triptrap13810 +Node: Runtime options15339 +Node: Commonalities17111 +Node: Option conventions17716 +Node: Common options18940 +Node: Path searching23452 +Node: Output file location24474 +Node: Three programs25514 +Node: Initial and virgin26273 +Node: Memory dumps27373 +Node: Creating memory dumps27840 +Node: Determining the memory dump to use29101 +Node: Hardware and memory dumps30725 +Node: Editor invocation33194 +Node: \input filenames33924 +Node: TeX36917 +Node: tex invocation38007 +Node: Initial TeX45939 +Node: Formats47428 +Node: Languages and hyphenation50367 +Node: MLTeX50795 +Node: \charsubdef52290 +Node: \tracingcharsubdef54616 +Node: TCX files55191 +Node: patgen invocation60615 +Node: IPC and TeX61332 +Node: TeX extensions61933 +Node: Metafont63234 +Node: mf invocation64522 +Node: Initial Metafont68405 +Node: Modes70158 +Node: Online Metafont graphics72413 +Node: gftodvi invocation75686 +Node: mft invocation77945 +Node: MetaPost82000 +Node: mpost invocation83021 +Node: Initial MetaPost88206 +Node: makempx invocation90018 +Node: dvitomp invocation94023 +Node: dmp invocation94652 +Node: mpto invocation98673 +Node: newer invocation99655 +Node: BibTeX100592 +Node: bibtex invocation100953 +Node: Basic BibTeX style files103278 +Node: WEB104620 +Node: tangle invocation105903 +Node: weave invocation108026 +Node: pooltype invocation109434 +Node: DVI utilities110564 +Node: dvicopy invocation111508 +Node: dvitype invocation112806 +Node: dvitype output example115161 +Node: Font utilities118212 +Node: Font file formats119392 +Node: gftopk invocation122691 +Node: pktogf invocation123895 +Node: pktype invocation125074 +Node: gftype invocation127909 +Node: tftopl invocation132425 +Node: pltotf invocation137059 +Node: vftovp invocation138124 +Node: vptovf invocation140408 +Node: Font utilities available elsewhere141462 +Node: Legalisms143882 +Node: References146053 +Node: Index150438 End Tag Table diff --git a/Master/texmf/doc/kpathsea/kpathsea.html b/Master/texmf/doc/kpathsea/kpathsea.html index a6a1d740a99..abb9e80ca55 100644 --- a/Master/texmf/doc/kpathsea/kpathsea.html +++ b/Master/texmf/doc/kpathsea/kpathsea.html @@ -9,7 +9,8 @@ <!-- This file documents the Kpathsea library for path searching. -Copyright (C) 1993-2005 Karl Berry & Olaf Weber. +Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, +2004, 2005, 2007 Karl Berry & Olaf Weber. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -51,8 +52,8 @@ Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> <h2 class="unnumbered">Kpathsea library</h2> <p>This manual documents how to install and use the Kpathsea library for -filename lookup. It corresponds to version 3.5.5, -released in June 2005. +filename lookup. It corresponds to version 3.5.6, +released in January 2007. <ul class="menu"> <li><a accesskey="1" href="#Introduction">Introduction</a>: Overview. @@ -78,8 +79,8 @@ Up: <a rel="up" accesskey="u" href="#Top">Top</a> <h2 class="chapter">1 Introduction</h2> <p><a name="index-introduction-1"></a><a name="index-fundamental-purpose-of-Kpathsea-2"></a> -This manual corresponds to version 3.5.5 of the Kpathsea -library, released in June 2005. +This manual corresponds to version 3.5.6 of the Kpathsea +library, released in January 2007. <p>The library's fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do when diff --git a/Master/texmf/doc/kpathsea/kpathsea.pdf b/Master/texmf/doc/kpathsea/kpathsea.pdf Binary files differindex 4e866f49f96..90b0f72fe34 100644 --- a/Master/texmf/doc/kpathsea/kpathsea.pdf +++ b/Master/texmf/doc/kpathsea/kpathsea.pdf diff --git a/Master/texmf/doc/web2c/web2c.html b/Master/texmf/doc/web2c/web2c.html index 12bd0120e51..96606579e2e 100644 --- a/Master/texmf/doc/web2c/web2c.html +++ b/Master/texmf/doc/web2c/web2c.html @@ -11,7 +11,7 @@ This file documents the installation and use of the programs in Web2c, an implementation of Donald Knuth's TeX system. Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, -2004 Karl Berry & Olaf Weber. +2004, 2005, 2007 Karl Berry & Olaf Weber. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -162,8 +162,8 @@ Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> <p>This document describes how to install and use the programs in the Web2c implementation of the TeX system, especially for Unix systems. It -corresponds to Web2c version 7.5.5, released in -June 2005. +corresponds to Web2c version 7.5.6, released in +January 2007. <ul class="menu"> <li><a accesskey="1" href="#Introduction">Introduction</a>: A brief introduction. @@ -193,8 +193,8 @@ Up: <a rel="up" accesskey="u" href="#Top">Top</a> <h2 class="chapter">1 Introduction</h2> <p><a name="index-introduction-1"></a> -This manual corresponds to version 7.5.5 of Web2c, released in -June 2005. +This manual corresponds to version 7.5.6 of Web2c, released in +January 2007. <p><a name="index-Knuth_002c-Donald-E_002e-2"></a><a name="index-g_t_0040TeX_007b_007d_002c-Web2c-implementation-of-3"></a><a name="index-Hobby_002c-John-4"></a><a name="index-Breitenlohner_002c-Peter-5"></a><dfn>Web2c</dfn> is the name of a TeX implementation, originally for Unix, but now also running under DOS, Amiga, and other operating systems. By @@ -2479,9 +2479,11 @@ to <var>mpfile</var>; default is `<samp><span class="samp">newer</span></samp>'. <br><dt><code>DMP</code><a name="index-DMP-544"></a><dd>Likewise, for Troff; default is `<samp><span class="samp">dmp</span></samp>'. - <br><dt><code>TEX</code><a name="index-TEX-545"></a><dd>The command run to typeset the labels in TeX; default is `<samp><span class="samp">tex</span></samp>'. -If you use LaTeX, set this to <code>latex</code>, and supply an appropriate -<code>verbatimtex</code> header in the MP source (see <a href="#mpost-invocation">mpost invocation</a>). + <br><dt><code>TEX</code><a name="index-TEX-545"></a><dd>The command run to typeset the labels in TeX; the default is +`<samp><span class="samp">etex</span></samp>', set in <samp><span class="file">texmf.cnf</span></samp>. If you use LaTeX, set this to +<code>latex</code>, and supply an appropriate <code>verbatimtex</code> header in +the MP source (see <a href="#mpost-invocation">mpost invocation</a>). Or put `<samp><span class="samp">%&latex</span></samp>' as +the first line of your LaTeX source. <br><dt><code>TROFF</code><a name="index-TROFF-546"></a><dd>Likewise, for Troff; default is `<samp><span class="samp">'eqn -d\$\$ | troff -Tpost'</span></samp>'. You may need to replace `<samp><span class="samp">-Tpost</span></samp>' by `<samp><span class="samp">-T</span><var>term</var></samp>', where @@ -2492,6 +2494,14 @@ e.g., `<samp><span class="samp">ps</span></samp>' or `<samp><span class="samp">p environment variable or configuration value to point to the appropriate font directory, traditionally <samp><span class="file">/usr/lib/font/dev</span><var>term</var></samp>. + <p>One more complication is whether the troff programs have a `<samp><span class="samp">g</span></samp>' +prefix. On Windows, TeX Live supports both ways: +<samp><span class="file">makempx.exe</span></samp> is built to use <samp><span class="file">gsoelim.exe</span></samp>, +<samp><span class="file">geqn.exe</span></samp>, and <samp><span class="file">gtroff.exe</span></samp>, while +<samp><span class="file">makempx-without-g-prefix.exe</span></samp> is built to use <samp><span class="file">soelim.exe</span></samp>, +<samp><span class="file">eqn.exe</span></samp>, and <samp><span class="file">troff.exe</span></samp>. MetaPost users on Windows using +troff for their labels should arrange to run the proper binary. + </dl> <div class="node"> diff --git a/Master/texmf/doc/web2c/web2c.pdf b/Master/texmf/doc/web2c/web2c.pdf Binary files differindex ab535d5f135..a7e215cd867 100644 --- a/Master/texmf/doc/web2c/web2c.pdf +++ b/Master/texmf/doc/web2c/web2c.pdf |