From d34e62f6c5fec68a9b3cb118a1d0bfcee6302726 Mon Sep 17 00:00:00 2001 From: Peter Breitenlohner Date: Tue, 3 Mar 2015 13:30:44 +0000 Subject: dvipng 1.15 git-svn-id: svn://tug.org/texlive/trunk@36426 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/dvipng/doc/COPYING.gd | 53 ------ Build/source/texk/dvipng/doc/Makefile.am | 3 +- Build/source/texk/dvipng/doc/Makefile.in | 1 - Build/source/texk/dvipng/doc/dvipng.1 | 64 ++++--- Build/source/texk/dvipng/doc/dvipng.help | 4 +- Build/source/texk/dvipng/doc/dvipng.info | 267 ++++++++++-------------------- Build/source/texk/dvipng/doc/dvipng.texi | 89 ++++------ Build/source/texk/dvipng/doc/install.texi | 29 ++-- Build/source/texk/dvipng/doc/readme.texi | 27 ++- 9 files changed, 178 insertions(+), 359 deletions(-) delete mode 100644 Build/source/texk/dvipng/doc/COPYING.gd (limited to 'Build/source/texk/dvipng/doc') diff --git a/Build/source/texk/dvipng/doc/COPYING.gd b/Build/source/texk/dvipng/doc/COPYING.gd deleted file mode 100644 index 4a91420256e..00000000000 --- a/Build/source/texk/dvipng/doc/COPYING.gd +++ /dev/null @@ -1,53 +0,0 @@ - - Portions copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, - 2002 by Cold Spring Harbor Laboratory. Funded under Grant - P41-RR02188 by the National Institutes of Health. - - Portions copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002 by - Boutell.Com, Inc. - - Portions relating to GD2 format copyright 1999, 2000, 2001, 2002 - Philip Warner. - - Portions relating to PNG copyright 1999, 2000, 2001, 2002 Greg - Roelofs. - - Portions relating to gdttf.c copyright 1999, 2000, 2001, 2002 John - Ellson (ellson@@lucent.com). - - Portions relating to gdft.c copyright 2001, 2002 John Ellson - (ellson@@lucent.com). - - Portions copyright 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 - Pierre-Alain Joye (pierre@@libgd.org). - - Portions relating to JPEG and to color quantization copyright 2000, - 2001, 2002, Doug Becker and copyright (C) 1994, 1995, 1996, 1997, - 1998, 1999, 2000, 2001, 2002, Thomas G. Lane. This software is - based in part on the work of the Independent JPEG Group. See the - file README-JPEG.TXT for more information. - - Portions relating to WBMP copyright 2000, 2001, 2002 Maurice - Szmurlo and Johan Van den Brande. - - Permission has been granted to copy, distribute and modify gd in - any context without fee, including a commercial application, - provided that this notice is present in user-accessible supporting - documentation. - - This does not affect your ownership of the derived work itself, and - the intent is to assure proper credit for the authors of gd, not to - interfere with your productive use of gd. If you have questions, - ask. "Derived works" includes all programs that utilize the - library. Credit must be given in user-accessible documentation. - - This software is provided "AS IS." The copyright holders disclaim - all warranties, either express or implied, including but not - limited to implied warranties of merchantability and fitness for a - particular purpose, with respect to this code and accompanying - documentation. - - Although their code does not appear in gd, the authors wish to thank - David Koblas, David Rowley, and Hutchison Avenue Software Corporation - for their prior contributions. - diff --git a/Build/source/texk/dvipng/doc/Makefile.am b/Build/source/texk/dvipng/doc/Makefile.am index 6cf506627fc..e61015bb4d5 100644 --- a/Build/source/texk/dvipng/doc/Makefile.am +++ b/Build/source/texk/dvipng/doc/Makefile.am @@ -1,12 +1,11 @@ ## Makefile.am for the TeX Live subdirectory texk/dvipng/doc/ ## -## Copyright (C) 2009-2013 Peter Breitenlohner +## Copyright (C) 2009-2015 Peter Breitenlohner ## You may freely use, modify and/or distribute this file. # info_TEXINFOS = \ dvipng.texi dvipng_TEXINFOS = \ - COPYING.gd \ dvipng.help \ install.texi \ macros.texi \ diff --git a/Build/source/texk/dvipng/doc/Makefile.in b/Build/source/texk/dvipng/doc/Makefile.in index 4c6ea6592bc..90b0f385768 100644 --- a/Build/source/texk/dvipng/doc/Makefile.in +++ b/Build/source/texk/dvipng/doc/Makefile.in @@ -357,7 +357,6 @@ info_TEXINFOS = \ dvipng.texi dvipng_TEXINFOS = \ - COPYING.gd \ dvipng.help \ install.texi \ macros.texi \ diff --git a/Build/source/texk/dvipng/doc/dvipng.1 b/Build/source/texk/dvipng/doc/dvipng.1 index e57ca8aa9ce..d81d4fcbbb7 100644 --- a/Build/source/texk/dvipng/doc/dvipng.1 +++ b/Build/source/texk/dvipng/doc/dvipng.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.20) +.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28) .\" .\" Standard preamble: .\" ======================================================================== @@ -38,6 +38,8 @@ . ds PI \(*p . ds L" `` . ds R" '' +. ds C` +. ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. @@ -48,17 +50,24 @@ .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. -.ie \nF \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" +.\" +.\" Avoid warning from groff about undefined register 'F'. +.de IX .. -. nr % 0 -. rr F -.\} -.el \{\ -. de IX +.nr rF 0 +.if \n(.g .if rF .nr rF 1 +.if (\n(rF:(\n(.g==0)) \{ +. if \nF \{ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" .. +. if !\nF==2 \{ +. nr % 0 +. nr F 2 +. \} +. \} .\} +.rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. @@ -124,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "DVIPNG 1" -.TH DVIPNG 1 "2013-07-09" "dvipng (TeX Live) 1.14" "User commands" +.TH DVIPNG 1 "2015-03-03" "dvipng (TeX Live) 1.15" "User commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -153,15 +162,15 @@ 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 \fB\-\-follow\fR switch that makes dvipng wait at end-of-file for further output, unless it finds the \s-1POST\s0 marker that -indicates the end of the \s-1DVI\s0. +indicates the end of the \s-1DVI.\s0 .IP "\(bu" 4 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. .IP "\(bu" 4 -Supports \s-1PK\s0, \s-1VF\s0, PostScript Type1, and TrueType fonts, subfonts (i.e., +Supports \s-1PK, VF,\s0 PostScript Type1, and TrueType fonts, subfonts (i.e., as used in CJK-LaTeX), color specials, and inclusion of PostScript, -\&\s-1PNG\s0, \s-1JPEG\s0 or \s-1GIF\s0 images. +\&\s-1PNG, JPEG\s0 or \s-1GIF\s0 images. .IP "\(bu" 4 and more... .SH "OPTIONS" @@ -205,7 +214,7 @@ below). .IP "\fB\-bg\fR \fIcolor_spec\fR" 4 .IX Item "-bg color_spec" Choose background color for the images. This option will be ignored if -there is a background color \especial in the \s-1DVI\s0. The color spec should +there is a background color \especial in the \s-1DVI.\s0 The color spec should be in TeX color \especial syntax, e.g., 'rgb 1.0 0.0 0.0'. You can also specify 'Transparent' or 'transparent' which will give you a transparent background with the normal background as a fallback color. A @@ -267,7 +276,7 @@ numbers rather than the physical page number. See the \fB\-o\fR switch. .IP "\fB\-fg\fR \fIcolor_spec\fR" 4 .IX Item "-fg color_spec" Choose foreground color for the images. This option will be ignored if -there is a foreground color \especial in the \s-1DVI\s0. The color spec should +there is a foreground color \especial in the \s-1DVI.\s0 The color spec should be in TeX color \especial syntax, e.g., 'rgb 1.0 0.0 0.0'. .IP "\fB\-\-follow*\fR" 4 .IX Item "--follow*" @@ -275,7 +284,7 @@ Wait for data at end-of-file. One of the benefits of dvipng is that it does not read the postamble, so it can be started before TeX finishes. This switch makes dvipng wait at end-of-file for further output, unless it finds the \s-1POST\s0 marker that indicates the end of the -\&\s-1DVI\s0. This is similar to \fBtail \-f\fR but for DVI-to-PNG conversion. +\&\s-1DVI.\s0 This is similar to \fBtail \-f\fR but for DVI-to-PNG conversion. .IP "\fB\-\-freetype*\fR" 4 .IX Item "--freetype*" Enable/disable FreeType font rendering (default on). This option is @@ -286,9 +295,7 @@ for rendering the fonts. If you have PostScript versions of Computer Modern installed, there will be no need to generate bitmapped (\s-1PK\s0) variants on disk of these. Then, you can render images at different (and unusual) resolutions without cluttering the disk with lots of bitmapped -fonts. Note that if you have both FreeType and T1lib on your system, -FreeType will be preferred by dvipng. If you for some reason would want -to use T1lib rendering, use this option. +fonts. .IP "\fB\-\-gamma\fR \fInum\fR" 4 .IX Item "--gamma num" Control the interpolation of colors in the greyscale anti-aliasing @@ -421,7 +428,7 @@ output; report no warnings (only errors) to standard error. .IP "\fB\-Q\fR \fInum\fR" 4 .IX Item "-Q num" Set the quality to \fInum\fR. That is, choose the number of antialiasing -levels for bitmapped fonts (\s-1PK\s0) and fonts rendered using T1lib, to be +levels for bitmapped fonts (\s-1PK\s0), to be \&\fInum\fR*\fInum\fR+1. The default value is 4 which gives 17 levels of antialiasing for antialiased fonts from these two. If FreeType is available, its rendering is unaffected by this option. @@ -446,24 +453,11 @@ and in addition the \s-1DVI\s0 origin, 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 \fBtight\fR will make dvipng only include all ink put on the page, producing neat images. -.IP "\fB\-\-t1lib*\fR" 4 -.IX Item "--t1lib*" -Enable T1lib font rendering (default on). This option is available if -the T1lib font library was present at compilation time. If this is the -case, dvipng will have direct support for PostScript Type1 fonts -internally, rather than using \fBgsftopk\fR for rendering the fonts. If -you have PostScript versions of Computer Modern installed, there will be -no need to generate bitmapped variants on disk of these. Then, you can -render images at different (and unusual) resolutions without cluttering -the disk with lots of bitmapped fonts. Note that if you have both -FreeType and T1lib on your system, FreeType will be preferred by dvipng, -and if you for some reason rather want to use T1lib, give the option -\&\fB\-\-freetype0\fR (see above). .IP "\fB\-\-truecolor*\fR" 4 .IX Item "--truecolor*" This will make \fBdvipng\fR generate truecolor output. Note that truecolor output is automatic if you include an external image in your -\&\s-1DVI\s0, e.g., via a PostScript special (i.e., the \fBgraphics\fR or +\&\s-1DVI,\s0 e.g., via a PostScript special (i.e., the \fBgraphics\fR or \&\fBgraphicx\fR package). This switch is overridden by the \&\fB\-\-palette\fR switch. .IP "\fB\-v*\fR" 4 @@ -510,4 +504,4 @@ This program is released under the \s-1GNU\s0 Lesser General Public License version 3, see the \s-1COPYING\s0 file in the dvipng distribution or <\fBhttp://www.gnu.org/licenses/gpl.html\fR>. .PP -Copyright (c) 2002\-2010 Jan-AAke Larsson +Copyright (c) 2002\-2015 Jan-AAke Larsson diff --git a/Build/source/texk/dvipng/doc/dvipng.help b/Build/source/texk/dvipng/doc/dvipng.help index 251ab8823c1..86566aee4dc 100644 --- a/Build/source/texk/dvipng/doc/dvipng.help +++ b/Build/source/texk/dvipng/doc/dvipng.help @@ -1,4 +1,4 @@ -This is ./dvipng (TeX Live) 1.14 Copyright 2002-2010 Jan-Ake Larsson +This is ./dvipng (TeX Live) 1.15 Copyright 2002-2015 Jan-Ake Larsson Usage: ./dvipng [OPTION]... FILENAME[.dvi] Options are chosen to be similar to dvips' options where possible: @@ -34,7 +34,7 @@ These do not correspond to dvips options: --png Output PNG images (dvipng default) --strict When a warning occurs, exit --truecolor* Truecolor output - -Q # Quality (T1lib and PK subsampling) + -Q # Quality (PK subsampling) --width* Output the image width on stdout -z # PNG compression level diff --git a/Build/source/texk/dvipng/doc/dvipng.info b/Build/source/texk/dvipng/doc/dvipng.info index c1062fb6d72..0f98fd5ebd4 100644 --- a/Build/source/texk/dvipng/doc/dvipng.info +++ b/Build/source/texk/dvipng/doc/dvipng.info @@ -1,4 +1,4 @@ -This is dvipng.info, produced by makeinfo version 5.1 from dvipng.texi. +This is dvipng.info, produced by makeinfo version 5.2 from dvipng.texi. INFO-DIR-SECTION TeX START-INFO-DIR-ENTRY @@ -15,7 +15,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.14 + This file documents dvipng version 1.15 Corrections or perhaps rewrites of sections are _very welcome_. @@ -98,11 +98,11 @@ Installing dvipng should be simple: merely './configure', 'make', and * Menu: -* Prerequisites:: -* Configure:: -* Build/install:: +* Prerequisites:: +* Configure:: +* Build/install:: * Installation outside the texmf tree:: -* Advice for non-privileged users:: +* Advice for non-privileged users::  File: dvipng.info, Node: Prerequisites, Next: Configure, Up: Installation @@ -144,15 +144,6 @@ File: dvipng.info, Node: Prerequisites, Next: Configure, Up: Installation want to render CJK-LaTeX characters, you must have FreeType 2 installed. - * 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 To be able to compress and write PNG files to disk, dvipng (or @@ -286,15 +277,15 @@ format. If there are four pages in 'foo.dvi', those pages will be output as 'foo1.png', 'foo2.png', 'foo3.png', and 'foo4.png', respectively. - If you have enabled the PostScript font support (via FreeType or -T1lib), fonts will be rendered as they are needed. Otherwise, dvipng -will use bitmapped (PK) fonts, and if you use PK fonts that have not -been used on your system before, they may be automatically generated; -this process can take a few minutes, so progress reports appear by -default. The next time the same font is used, it will have been saved -on disk, so rendering will go much faster. (If dvipng tries to -endlessly generate the same fonts over and over again, something is -wrong. *Note (kpathsea)Unable to generate fonts::.) + If you have enabled the PostScript font support (via FreeType), fonts +will be rendered as they are needed. Otherwise, dvipng will use +bitmapped (PK) fonts, and if you use PK fonts that have not been used on +your system before, they may be automatically generated; this process +can take a few minutes, so progress reports appear by default. The next +time the same font is used, it will have been saved on disk, so +rendering will go much faster. (If dvipng tries to endlessly generate +the same fonts over and over again, something is wrong. *Note +(kpathsea)Unable to generate fonts::.) Many options are available (see the next section). For a brief summary of available options, just type @@ -324,7 +315,7 @@ 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 (TeX Live) 1.14 Copyright 2002-2010 Jan-Ake Larsson + This is ./dvipng (TeX Live) 1.15 Copyright 2002-2015 Jan-Ake Larsson Usage: ./dvipng [OPTION]... FILENAME[.dvi] Options are chosen to be similar to dvips' options where possible: @@ -360,13 +351,14 @@ dvipng with no arguments or with the standard '--help' option. --png Output PNG images (dvipng default) --strict When a warning occurs, exit --truecolor* Truecolor output - -Q # Quality (T1lib and PK subsampling) + -Q # Quality (PK subsampling) --width* Output the image width on stdout -z # PNG compression level # = number f = file s = string * = suffix, '0' to turn off c = comma-separated dimension pair (e.g., 3.2in,-32.1cm) +  File: dvipng.info, Node: Option details, Prev: Option summary, Up: Command-line options @@ -480,10 +472,7 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. PostScript versions of Computer Modern installed, there will be no need to generate bitmapped (PK) variants on disk of these. Then, you can render images at different (and unusual) resolutions - without cluttering the disk with lots of bitmapped fonts. Note - that if you have both FreeType and T1lib on your system, FreeType - will be preferred by dvipng. If you for some reason would want to - use T1lib rendering, use this option. + without cluttering the disk with lots of bitmapped fonts. '--gamma NUM' Control the interpolation of colors in the greyscale anti-aliasing @@ -614,10 +603,10 @@ 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 bitmapped fonts (PK) and fonts rendered using T1lib, 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. + levels for bitmapped fonts (PK), 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 @@ -640,20 +629,6 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. image. The value 'tight' will make dvipng only include all ink put on the page, producing neat images. -'--t1lib*' - Enable T1lib font rendering (default on). This option is available - if the T1lib font library was present at compilation time. If this - is the case, dvipng will have direct support for PostScript Type1 - fonts internally, rather than using 'gsftopk' for rendering the - fonts. If you have PostScript versions of Computer Modern - installed, there will be no need to generate bitmapped variants on - disk of these. Then, you can render images at different (and - unusual) resolutions without cluttering the disk with lots of - bitmapped fonts. Note that if you have both FreeType and T1lib on - your system, FreeType will be preferred by dvipng, and if you for - some reason rather want to use T1lib, give the option '--freetype0' - (see above). - '--truecolor*' This will make 'dvipng' generate truecolor output. Note that truecolor output is automatic if you include an external image in @@ -823,8 +798,8 @@ color specification. * Menu: -* Color specifications:: -* Color specials:: +* Color specifications:: +* Color specials::  File: dvipng.info, Node: Color specifications, Next: Color specials, Up: Color @@ -954,14 +929,12 @@ track all classes, you can use '-1'. 256 GhostScript specials 512 - T1lib calls -1024 Kpathsea 'stat' calls -2048 +1024 Kpathsea hash table lookups -4096 +2048 Kpathsea path element expansion -8192 +4096 Kpathsea path searches  @@ -987,61 +960,6 @@ Ridderstro"m, Ezra Peisach, William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin Smith, Jason Riedy, Wolfram Krause, Reinhard Kotucha, Takeshi Abe, and Waldeck Schutzer. - Use of the 'gd' library requires inclusion of the following copyright -notice, which applies to the 'gd' library: - - Portions copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, - 2002 by Cold Spring Harbor Laboratory. Funded under Grant - P41-RR02188 by the National Institutes of Health. - - Portions copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002 by - Boutell.Com, Inc. - - Portions relating to GD2 format copyright 1999, 2000, 2001, 2002 - Philip Warner. - - Portions relating to PNG copyright 1999, 2000, 2001, 2002 Greg - Roelofs. - - Portions relating to gdttf.c copyright 1999, 2000, 2001, 2002 John - Ellson (ellson@lucent.com). - - Portions relating to gdft.c copyright 2001, 2002 John Ellson - (ellson@lucent.com). - - Portions copyright 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007 - Pierre-Alain Joye (pierre@libgd.org). - - Portions relating to JPEG and to color quantization copyright 2000, - 2001, 2002, Doug Becker and copyright (C) 1994, 1995, 1996, 1997, - 1998, 1999, 2000, 2001, 2002, Thomas G. Lane. This software is - based in part on the work of the Independent JPEG Group. See the - file README-JPEG.TXT for more information. - - Portions relating to WBMP copyright 2000, 2001, 2002 Maurice - Szmurlo and Johan Van den Brande. - - Permission has been granted to copy, distribute and modify gd in - any context without fee, including a commercial application, - provided that this notice is present in user-accessible supporting - documentation. - - This does not affect your ownership of the derived work itself, and - the intent is to assure proper credit for the authors of gd, not to - interfere with your productive use of gd. If you have questions, - ask. "Derived works" includes all programs that utilize the - library. Credit must be given in user-accessible documentation. - - This software is provided "AS IS." The copyright holders disclaim - all warranties, either express or implied, including but not - limited to implied warranties of merchantability and fitness for a - particular purpose, with respect to this code and accompanying - documentation. - - Although their code does not appear in gd, the authors wish to - thank David Koblas, David Rowley, and Hutchison Avenue Software - Corporation for their prior contributions. -  File: dvipng.info, Node: Copying, Next: Index, Prev: Credits, Up: Top @@ -1064,7 +982,7 @@ License along with this program. If not, see -Copyright (C) 2002-2010 Jan-AAke Larsson +Copyright (C) 2002-2015 Jan-AAke Larsson  File: dvipng.info, Node: Index, Prev: Copying, Up: Top @@ -1075,79 +993,78 @@ Index [index] * Menu: -* -dSAFER: Option details. (line 166) -* absolute page number, and '-l': Option details. (line 140) -* absolute page number, and '-p': Option details. (line 193) -* antialiasing levels, number of: Option details. (line 246) +* -dSAFER: Option details. (line 163) +* absolute page number, and '-l': Option details. (line 137) +* absolute page number, and '-p': Option details. (line 190) +* antialiasing levels, number of: Option details. (line 243) * background color (option): Option details. (line 40) * base resolution, setting: Option details. (line 33) * baseline reporting: Option details. (line 76) -* baseline reporting <1>: Option details. (line 132) +* baseline reporting <1>: Option details. (line 129) * color specifications: Color specifications. (line 6) * command-line options: Command-line options. (line 6) * compilation: Installation. (line 6) -* compression: Option details. (line 312) +* compression: Option details. (line 295) * configuration, of dvipng: Installation. (line 6) -* dark fonts: Option details. (line 119) +* dark fonts: Option details. (line 116) * debugging: Option details. (line 54) * debugging <1>: Diagnosing problems. (line 6) * depth reporting: Option details. (line 76) -* exit on erroneous images: Option details. (line 257) -* first page printed: Option details. (line 193) +* exit on erroneous images: Option details. (line 254) +* first page printed: Option details. (line 190) * follow mode: Option details. (line 97) -* font generation, avoiding: Option details. (line 158) -* forcing palette output: Option details. (line 202) +* font generation, avoiding: Option details. (line 155) +* forcing palette output: Option details. (line 199) * foreground color (option): Option details. (line 91) * 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 162) -* GIF image format: Option details. (line 125) -* height reporting: Option details. (line 132) +* fuzzy images: Option details. (line 116) +* gamma: Option details. (line 116) +* GhostScript and -dSAFER: Option details. (line 163) +* GhostScript, turning off: Option details. (line 159) +* GIF image format: Option details. (line 122) +* height reporting: Option details. (line 129) * installation, of dvipng: Installation. (line 6) * invoking dvipng: Basic usage. (line 6) -* last page printed: Option details. (line 140) -* light fonts: Option details. (line 119) -* magnification, overriding DVI: Option details. (line 302) -* Metafont mode, specifying: Option details. (line 149) -* mktexpk, avoiding: Option details. (line 158) -* mode name, specifying: Option details. (line 149) -* no erroneous images: Option details. (line 211) -* offset pages: Option details. (line 187) +* last page printed: Option details. (line 137) +* light fonts: Option details. (line 116) +* magnification, overriding DVI: Option details. (line 285) +* Metafont mode, specifying: Option details. (line 146) +* mktexpk, avoiding: Option details. (line 155) +* mode name, specifying: Option details. (line 146) +* no erroneous images: Option details. (line 208) +* offset pages: Option details. (line 184) * option, details of: Option details. (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 180) -* page range: Option details. (line 224) -* page, first printed: Option details. (line 193) -* page, last printed: Option details. (line 140) -* physical page number, and '-l': Option details. (line 140) -* physical page number, and '-p': Option details. (line 193) -* PNG image format: Option details. (line 220) +* output, redirecting: Option details. (line 177) +* page range: Option details. (line 221) +* page, first printed: Option details. (line 190) +* page, last printed: Option details. (line 137) +* physical page number, and '-l': Option details. (line 137) +* physical page number, and '-p': Option details. (line 190) +* PNG image format: Option details. (line 217) * PostScript inclusion problems: Encapsulated PostScript. (line 21) * PostScript, turning off raw PostScript specials: Option details. - (line 174) + (line 171) * problems: Diagnosing problems. (line 6) -* quality: Option details. (line 246) -* quiet operation: Option details. (line 242) -* reverse pagination: Option details. (line 253) -* silent operation: Option details. (line 242) +* quality: Option details. (line 243) +* quiet operation: Option details. (line 239) +* reverse pagination: Option details. (line 250) +* silent operation: Option details. (line 239) * standard input, reading options from: Option details. (line 11) -* standard output, output to: Option details. (line 180) -* T1lib font rendering: Option details. (line 274) +* standard output, output to: Option details. (line 177) * transparent border fallback color: Option details. (line 23) * transparent border width: Option details. (line 23) * trouble: Diagnosing problems. (line 6) -* truecolor output: Option details. (line 288) -* warnings, suppressing: Option details. (line 242) -* width reporting: Option details. (line 299) +* truecolor output: Option details. (line 271) +* warnings, suppressing: Option details. (line 239) +* width reporting: Option details. (line 282)  @@ -1155,27 +1072,27 @@ Tag Table: Node: Top296 Node: Introduction1191 Node: Installation3436 -Node: Prerequisites3834 -Node: Configure6331 -Node: Build/install8378 -Node: Installation outside the texmf tree8846 -Node: Advice for non-privileged users9556 -Node: Basic usage10567 -Node: Command-line options11720 -Node: Option summary12143 -Node: Option details14526 -Node: Graphics30489 -Node: Encapsulated PostScript31244 -Node: Bitmapped graphics32594 -Node: Raw PostScript33822 -Node: Color36075 -Node: Color specifications36486 -Node: Color specials37589 -Node: Diagnosing problems39006 -Node: Contact information39490 -Node: Debug options40218 -Node: Credits41229 -Node: Copying44830 -Node: Index45611 +Node: Prerequisites3783 +Node: Configure5823 +Node: Build/install7870 +Node: Installation outside the texmf tree8338 +Node: Advice for non-privileged users9048 +Node: Basic usage10059 +Node: Command-line options11203 +Node: Option summary11626 +Node: Option details14000 +Node: Graphics28938 +Node: Encapsulated PostScript29693 +Node: Bitmapped graphics31043 +Node: Raw PostScript32271 +Node: Color34524 +Node: Color specifications34913 +Node: Color specials36016 +Node: Diagnosing problems37433 +Node: Contact information37917 +Node: Debug options38645 +Node: Credits39634 +Node: Copying40840 +Node: Index41621  End Tag Table diff --git a/Build/source/texk/dvipng/doc/dvipng.texi b/Build/source/texk/dvipng/doc/dvipng.texi index 0235c349b4b..16a40ec3a0c 100644 --- a/Build/source/texk/dvipng/doc/dvipng.texi +++ b/Build/source/texk/dvipng/doc/dvipng.texi @@ -9,8 +9,8 @@ dvipng [options] [filename] - @c man end @end ifset -@set version 1.14 -@set month-year October 2010 +@set version 1.15 +@set month-year February 2015 @c Put everything in one index (arbitrarily chosen to be the concept index). @syncodeindex fn cp @@ -39,8 +39,8 @@ dvipng [options] [filename] - @author by Jan-@AA{}ke Larsson. @page @vskip 0pt plus 1filll -Copyright @copyright{} 2002-2010 Jan-@AA{}ke Larsson - +Copyright @copyright{} 2002-2015 Jan-@AA{}ke Larsson + Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. @@ -131,7 +131,7 @@ PNG format. If there are four pages in @file{foo.dvi}, those pages will be output as @file{foo1.png}, @file{foo2.png}, @file{foo3.png}, and @file{foo4.png}, respectively. -If you have enabled the PostScript font support (via FreeType or T1lib), +If you have enabled the PostScript font support (via FreeType), fonts will be rendered as they are needed. Otherwise, dvipng will use bitmapped (PK) fonts, and if you use PK fonts that have not been used on your system before, they may be automatically generated; this process @@ -239,12 +239,12 @@ both variants will use the latter behaviour. @xref{Color}. Set the debug flags, showing what dvipng (thinks it) is doing. This will work unless dvipng has been compiled without the @code{DEBUG} option (not recommended). Set the flags as you need them, use @samp{-d -1} as -the first option for maximum output. @xref{Debug options}. +the first option for maximum output. @xref{Debug options}. @item -D @var{num} @cindex output resolution, setting Set the output resolution, both horizontal and vertical, to @var{num} -dpi (dots per inch). +dpi (dots per inch). One may want to adjust this to fit a certain text font size (e.g., on a web page), and for a text font height of @var{font_px} pixels (in @@ -258,7 +258,7 @@ proprietary browsers have font height in pt (points), not pixels. You have to rescale that to pixels, using the screen resolution (default is usually 96 dpi) which means the formula is @example -@var{font_px} = @var{font_pt} * 96 / 72 [pt * px/in / (pt/in)] +@var{font_px} = @var{font_pt} * 96 / 72 [pt * px/in / (pt/in)] @end example On some high-res screens, the value is instead 120 dpi. Good luck! @@ -346,9 +346,7 @@ for rendering the fonts. If you have PostScript versions of Computer Modern installed, there will be no need to generate bitmapped (PK) variants on disk of these. Then, you can render images at different (and unusual) resolutions without cluttering the disk with lots of bitmapped -fonts. Note that if you have both FreeType and T1lib on your system, -FreeType will be preferred by dvipng. If you for some reason would want -to use T1lib rendering, use this option. +fonts. @item --gamma @var{num} @cindex gamma @@ -408,7 +406,7 @@ Kpathsea}. @pindex mktexpk@r{, avoiding} @c this description repeated in kpathsea.texi This option only has an effect when using bitmapped (PK) fonts. It turns -off automatic PK font generation (@file{mktexpk}). +off automatic PK font generation (@file{mktexpk}). @ignore @flindex missfont.log If @code{mktexpk}, the invocation is appended to a file @@ -459,10 +457,10 @@ file was @samp{@var{file}.dvi}. @cindex offset pages Move the origin by @var{x-offset},@var{y-offset}, a comma-separated pair of dimensions such as @samp{.1in,-.3cm}. -@c (@pxref{papersize special}). +@c (@pxref{papersize special}). The origin of the page is shifted from the default position (of one inch down, one inch to the right from the upper left corner of -the paper) by this amount. +the paper) by this amount. @item -p [=]@var{num} @cindex first page printed @@ -533,7 +531,7 @@ output; report no warnings (only errors) to standard error. @cindex antialiasing levels@r{, number of} @cindex quality Set the quality to @var{num}. That is, choose the number of antialiasing -levels for bitmapped fonts (PK) and fonts rendered using T1lib, to be +levels for bitmapped fonts (PK), to be @var{num}*@var{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. @@ -566,7 +564,7 @@ output files, and opening of any absolute filenames. Set the paper type to @var{papertype}. @c usually defined in one of the @c configuration files, along with the appropriate PostScript code to -@c select it (@pxref{Config file paper sizes}). +@c select it (@pxref{Config file paper sizes}). You can also specify a @var{papertype} of @samp{landscape}, which rotates a document by 90 degrees. To rotate a document whose paper type is not the default, you can use the @samp{-t} option twice, once for the @@ -590,23 +588,9 @@ and in addition the DVI origin, 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 @samp{tight} will make dvipng only include all ink put on the page, producing neat images. -@c (@pxref{papersize special}). +@c (@pxref{papersize special}). @c This option overrides any papersize special in the DVI file. -@item --t1lib* -@cindex T1lib font rendering -Enable T1lib font rendering (default on). This option is available if -the T1lib font library was present at compilation time. If this is the -case, dvipng will have direct support for PostScript Type1 fonts -internally, rather than using @samp{gsftopk} for rendering the fonts. If -you have PostScript versions of Computer Modern installed, there will be -no need to generate bitmapped variants on disk of these. Then, you can -render images at different (and unusual) resolutions without cluttering -the disk with lots of bitmapped fonts. Note that if you have both -FreeType and T1lib on your system, FreeType will be preferred by dvipng, -and if you for some reason rather want to use T1lib, give the option -@samp{--freetype0} (see above). - @item --truecolor* @cindex truecolor output This will make @samp{dvipng} generate truecolor output. Note that @@ -614,8 +598,8 @@ truecolor output is automatic if you include an external image in your DVI, e.g., via a PostScript special (i.e., the @samp{graphics} or @samp{graphicx} package). This switch is overridden by the @samp{--palette} switch. - -@item -v* + +@item -v* Enable verbose operation. This will currently indicate what fonts is used, in addition to the usual output. @@ -664,7 +648,7 @@ correspond directly to the zlib compression levels.'' @c man end @node Graphics -@chapter Graphics +@chapter Graphics @samp{dvipng} attempts to handle graphics as included by the @samp{graphicx} and @samp{graphics} packages, without the need of @@ -789,8 +773,8 @@ specials start with the keyword @samp{color} or the keyword @samp{background}, followed by a color specification. @menu -* Color specifications:: -* Color specials:: +* Color specifications:: +* Color specials:: @end menu @@ -804,9 +788,9 @@ by-value spec starts with the name of a color model (one of @samp{rgb}, @samp{hsb}, @samp{cmy}, @samp{cmyk}, or @samp{gray}) followed by the appropriate number of parameters. Thus, the color specification @samp{rgb 0.3 0.4 0.5} would correspond to the color that is @samp{0.3 -0.4 0.5} in its red, blue and green values. The color model used -internally in dvipng is @samp{RGB} (discretized to 256 levels), for -details on the formulas used in conversion, see the @samp{xcolor} +0.4 0.5} in its red, blue and green values. The color model used +internally in dvipng is @samp{RGB} (discretized to 256 levels), for +details on the formulas used in conversion, see the @samp{xcolor} documentation. By-name color specifications are single (case-dependent) words and are @@ -869,7 +853,7 @@ yourself in such a situation. @section Contact information Bug reports should be sent to -@email{dvipng@@nongnu.org}. +@email{dvipng@@nongnu.org}. Questions, suggestions for new features, pleas for help, and/or praise should go to @email{dvipng@@nongnu.org}. For more information on this @@ -892,14 +876,14 @@ 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}. +track all classes, you can use @code{-1}. Some of these debugging options are actually provided by Kpathsea (@pxref{Debugging, , , kpathsea, Kpathsea}). The classes are: @table @asis -@item 1 +@item 1 Normal dvi op-codes @item 2 Virtual fonts @@ -918,16 +902,15 @@ Color specials @item 256 GhostScript specials @item 512 -T1lib calls -@item 1024 Kpathsea @code{stat} calls -@item 2048 +@item 1024 Kpathsea hash table lookups -@item 4096 +@item 2048 Kpathsea path element expansion -@item 8192 +@item 4096 Kpathsea path searches @ignore +@item 8192 @item 16384 @end ignore @@ -954,13 +937,6 @@ William H Wheeler, Thomas Klausner, Harald Koenig, Adrian Bunk, Kevin Smith, Jason Riedy, Wolfram Krause, Reinhard Kotucha, Takeshi Abe, and Waldeck Schutzer. -Use of the @code{gd} library requires inclusion of the following -copyright notice, which applies to the @code{gd} library: - -@quotation -@include COPYING.gd -@end quotation - @ifset man @c man begin NOTES The full manual is accessible in info format, on most systems by typing @@ -973,7 +949,7 @@ This program is released under the GNU Lesser General Public License version 3, see the COPYING file in the dvipng distribution or @url{http://www.gnu.org/licenses/gpl.html}. -Copyright @copyright{} 2002-2010 Jan-@AA{}ke Larsson +Copyright @copyright{} 2002-2015 Jan-@AA{}ke Larsson @c man end @end ifset @@ -996,11 +972,10 @@ License along with this program. If not, see @sp 2 @noindent -Copyright @copyright{} 2002-2010 Jan-@AA{}ke Larsson +Copyright @copyright{} 2002-2015 Jan-@AA{}ke Larsson @node Index @unnumbered Index @printindex cp @bye - diff --git a/Build/source/texk/dvipng/doc/install.texi b/Build/source/texk/dvipng/doc/install.texi index c58f9af6013..c9928a1ba7e 100644 --- a/Build/source/texk/dvipng/doc/install.texi +++ b/Build/source/texk/dvipng/doc/install.texi @@ -1,5 +1,5 @@ @c install.texi -@c +@c @c Part of the dvipng distribution @include macros.texi @@ -9,15 +9,15 @@ @end ifset @c ----------------------- Installing dvipng should be simple: merely @code{./configure}, -@code{make}, and @code{make install}. +@code{make}, and @code{make install}. @ifclear rawfile @menu -* Prerequisites:: -* Configure:: -* Build/install:: +* Prerequisites:: +* Configure:: +* Build/install:: * Installation outside the texmf tree:: -* Advice for non-privileged users:: +* Advice for non-privileged users:: @end menu @end ifclear @@ -57,15 +57,6 @@ resolutions without cluttering the disk with lots of bitmapped fonts. Finally, it will enable subfont support in dvipng. That is, if you want to render CJK-@LaTeX{} characters, you must have FreeType 2 installed. -@item 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. - @item libpng and libz To be able to compress and write PNG files to disk, dvipng (or really @@ -74,7 +65,7 @@ any modern system, if not, download them and install them. @item The @code{texinfo} package -This is needed for building the documentation. +This is needed for building the documentation. @end itemize @node Configure @@ -150,7 +141,7 @@ Once @file{configure} has been run, simply enter make @end example -@noindent +@noindent at the prompt to compile the C code, and build the documentation files. To install the files into the locations chosen earlier, type @@ -158,7 +149,7 @@ To install the files into the locations chosen earlier, type make install @end example -@noindent +@noindent You may need special privileges to install, e.g., if you are installing into system directories. @@ -199,5 +190,5 @@ This program is released under the GNU Lesser General Public License version 3, see the COPYING file in the dvipng distribution or @url{http://www.gnu.org/licenses/}. -Copyright @copyright{} 2002-2009 Jan-@AA{}ke Larsson +Copyright @copyright{} 2002-2015 Jan-@AA{}ke Larsson @end ifset diff --git a/Build/source/texk/dvipng/doc/readme.texi b/Build/source/texk/dvipng/doc/readme.texi index 378333376ae..32faa64c02b 100644 --- a/Build/source/texk/dvipng/doc/readme.texi +++ b/Build/source/texk/dvipng/doc/readme.texi @@ -12,7 +12,7 @@ @c ----------------------- This program makes PNG and/or GIF graphics from DVI files as obtained -from @TeX{} and its relatives. +from @TeX{} and its relatives. If GIF support is enabled, GIF output is chosen by using the @samp{dvigif} binary or with the @samp{--gif} option. @@ -24,7 +24,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 @previewlatex{} (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 @url{http://www.gnu.org/software/auctex/preview-latex.html}. +buffer, see @url{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 @@ -47,28 +47,28 @@ and WYSIWYG editors like LyX. The benefits of @samp{dvipng}/@samp{dvigif} include @itemize @bullet -@item +@item 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 @previewlatex{}, WeBWorK and others. -@item +@item It does not read the postamble, so it can be started before @TeX{} finishes. There is a @samp{--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. -@item +@item 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. -@item +@item 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. -@item +@item and more... @end itemize @@ -105,7 +105,7 @@ The dvipng package is available at Savannah, the GNU project site. Since dvipng is not part of the GNU project, although released under the GNU GPL, the web address is @url{http://savannah.nongnu.org/projects/dvipng}. Instructions for -anonymous CVS access can be found at +anonymous CVS access can be found at @url{http://savannah.nongnu.org/cvs/?group=dvipng}. @section Contacts @@ -127,7 +127,7 @@ This program is released under the GNU Lesser General Public License version 3, see the COPYING file in the dvipng distribution or @url{http://www.gnu.org/licenses/}. -Copyright @copyright{} 2002-2009 Jan-@AA{}ke Larsson +Copyright @copyright{} 2002-2014 Jan-@AA{}ke Larsson @section Todo @@ -138,19 +138,16 @@ Use gs interpreter library for speed and possibly for functionality. @item Add more color models for xcolor compatibility -@item -Fix T1lib and PK rendering so it is on par with Freetype. - @item Enable a named pipe as DVI -@item +@item Further speed improvements. -@item +@item Other output specials and source specials. -@item +@item Clean internal structures. Overhaul file handling. @item -- cgit v1.2.3