#! /bin/sh /usr/share/dpatch/dpatch-run

## 20_manpage_fixes.dpatch by Erik Schanze <eriks@debian.org>

##

## All lines beginning with `## DP:' are a description of the patch.

## DP: fixes typos, unmasked hyphens and explain, what no other option 

## DP: wil work together with -d option on web2png (bug: #285329) 

@DPATCH@

diff -urNad gif2png-2.5.1~/gif2png.1 gif2png-2.5.1/gif2png.1

--- gif2png-2.5.1~/gif2png.1	2003-12-26 22:10:50.000000000 +0100

+++ gif2png-2.5.1/gif2png.1	2005-10-03 18:07:33.500519299 +0200

@@ -23,112 +23,112 @@

 .SH "SYNOPSIS"

 .nf

-\fBgif2png\fR [-bdfghinprsvwO] [\fIfile.[gif]\fR...]

+\fBgif2png\fR [\-bdfghinprsvwO] [\fIfile.[gif]\fR...]

 .fi

 .SH "DESCRIPTION"

 .PP

-The \fBgif2png\fR program converts files in the obsolescent and patent-encumbered Graphic Interchange Format (GIF) to Portable Network Graphics (PNG) format, an open W3C standard.

+The \fBgif2png\fR program converts files in the obsolescent and patent\-encumbered Graphic Interchange Format (GIF) to Portable Network Graphics (PNG) format, an open W3C standard.

 .PP

 Normally \fBgif2png\fR converts each file named on the command line, leaving the original in place. If a name does not have a .gif extension, the unmodified name will be tried first, followed by the name with .gif appended. For each file named `foo.gif', a foo.png will be created.

 .PP

-When a multi-image GIF file named foo.gif is converted, gif2png creates multiple PNG files, each containing one frame; their names will be foo.png, foo.p01, foo.p02 etc.

+When a multi\-image GIF file named foo.gif is converted, gif2png creates multiple PNG files, each containing one frame; their names will be foo.png, foo.p01, foo.p02 etc.

 .PP

 If no source files are specified and stdin is a terminal, \fBgif2png\fR lists a usage summary and version information, then exits.

 .PP

-If no source files are specified, and stdin is a device or pipe, stdin is converted to noname.png. (The program can't be a normal stdin-to-stdout filter because of the possibility that the input GIF might have multiple images).

+If no source files are specified, and stdin is a device or pipe, stdin is converted to noname.png. (The program can't be a normal stdin\-to\-stdout filter because of the possibility that the input GIF might have multiple images).

 .PP

-However, if filter mode is forced (with -f) stdin will be converted to stdout, with \fBgif2png\fR returning an error code if the GIF is multi-image.

+However, if filter mode is forced (with \-f) stdin will be converted to stdout, with \fBgif2png\fR returning an error code if the GIF is multi\-image.

 .PP

-The program will preserve the information contained in a GIF file as closely as possible, including GIF comment and application-data extension blocks. All graphics data (pixels, RGB color tables) will be converted without loss of information. Transparency is also preserved. There is one exception; GIF plain-text extensions are skipped.

+The program will preserve the information contained in a GIF file as closely as possible, including GIF comment and application\-data extension blocks. All graphics data (pixels, RGB color tables) will be converted without loss of information. Transparency is also preserved. There is one exception; GIF plain\-text extensions are skipped.

 .PP

-The program automatically converts interlaced GIFs to interlaced PNGs. It detects images in which all colors are gray (equal R, G, and B values) and converts such images to PNG grayscale. Other images are converted to use the PNG palette type. Duplicate color entries are silently preserved. Unused color-table entries cause an error message.

+The program automatically converts interlaced GIFs to interlaced PNGs. It detects images in which all colors are gray (equal R, G, and B values) and converts such images to PNG grayscale. Other images are converted to use the PNG palette type. Duplicate color entries are silently preserved. Unused color\-table entries cause an error message.

 .PP

-The action of the program can be modified with the following command-line switches:

+The action of the program can be modified with the following command\-line switches:

 .TP

-\fB-b\fR {#}RRGGBB

-Background. Replace transparent pixels with given RGB value, six hexadecimal digits interpreted as two hexits each of red, green, and blue value. The value may optionally be led with a #, HTML-style.

+\fB\-b\fR {#}RRGGBB

+Background. Replace transparent pixels with given RGB value, six hexadecimal digits interpreted as two hexits each of red, green, and blue value. The value may optionally be led with a #, HTML\-style.

 .TP

-\fB-d \fR

+\fB\-d \fR

 Delete source GIF files after successful conversion.

 .TP

-\fB-f \fR

-Filter mode. Convert GIF on stdin to PNG on stdout, return error if the GIF is multi-image.

+\fB\-f \fR

+Filter mode. Convert GIF on stdin to PNG on stdout, return error if the GIF is multi\-image.

 .TP

-\fB-g \fR

+\fB\-g \fR

 Write gamma=1/2.2 and sRGB chunks in the PNG.

 .TP

-\fB-h \fR

-Generate PNG color-frequency histogram chunks into converted color files.

+\fB\-h \fR

+Generate PNG color\-frequency histogram chunks into converted color files.

 .TP

-\fB-i \fR

+\fB\-i \fR

 Force conversion to interlaced PNG files.

 .TP

-\fB-n \fR

-Force conversion to non-interlaced PNG files.

+\fB\-n \fR

+Force conversion to non\-interlaced PNG files.

 .TP

-\fB-p \fR

+\fB\-p \fR

 Display progress of PNG writing.

 .TP

-\fB-r \fR

+\fB\-r \fR

 Try to recover data from corrupted GIF files.

 .TP

-\fB-s \fR

+\fB\-s \fR

 Do not translate the GIF Software chunk to a PNG annotation.

 .TP

-\fB-t \fR

-Change behavior of web-probe (-w) mode to accept GIFs with transparency.

+\fB\-t \fR

+Change behavior of web\-probe (\-w) mode to accept GIFs with transparency.

 .TP

-\fB-v \fR

-Verbose mode; show summary line, -vv enables conversion-statistics and debugging messages.

+\fB\-v \fR

+Verbose mode; show summary line, \-vv enables conversion\-statistics and debugging messages.

 .TP

-\fB-w \fR

-Web-probe switch; list GIFs that do not have multiple images or transparency to stdout. GIFs that fail this filter cause error messages to stderr.

+\fB\-w \fR

+Web\-probe switch; list GIFs that do not have multiple images or transparency to stdout. GIFs that fail this filter cause error messages to stderr.

 .TP

-\fB -O \fR

-Optimize; remove unused color-table entries. Normally these trigger an error message and disable \fB-d\fR (but conversion is completed anyway). Also, use zlib compression level 9 (best compression) instead of the default level. The recovery algorithm enabled by \fB-r\fR is as follows: Unused color table entries will not trigger an error message as they normally do, but will still be preserved unless \fB-O\fR is also on, in which case they will be discarded. Missing color tables will be patched with a default that puts black at index 0, white at index 1, and supplies red, green, blue, yellow, purple and cyan as the remaining color values. Missing image pixels will be set to 0. Unrecognized or corrupted extensions will be discarded.

+\fB\-O \fR

+Optimize; remove unused color\-table entries. Normally these trigger an error message and disable \fB\-d\fR (but conversion is completed anyway). Also, use zlib compression level 9 (best compression) instead of the default level. The recovery algorithm enabled by \fB\-r\fR is as follows: Unused color table entries will not trigger an error message as they normally do, but will still be preserved unless \fB\-O\fR is also on, in which case they will be discarded. Missing color tables will be patched with a default that puts black at index 0, white at index 1, and supplies red, green, blue, yellow, purple and cyan as the remaining color values. Missing image pixels will be set to 0. Unrecognized or corrupted extensions will be discarded.

 .SH "PROBLEMS"

 .PP

-Naively converting all your GIFs at one go with \fBgif2png\fR is not likely to give you the results you want. The problem is not with PNG itself or with gif2png, but with the poor-to-nonexistent support for PNG transparency and animation in most browsers.

+Naively converting all your GIFs at one go with \fBgif2png\fR is not likely to give you the results you want. The problem is not with PNG itself or with gif2png, but with the poor\-to\-nonexistent support for PNG transparency and animation in most browsers.

 .PP

-The web-probe switch is intended to be used with scripts for converting web sites. All PNGs generated from the pathnames it returns will be properly rendered in Netscape Navigator 4.04+, Internet Explorer versions 4.0b1+, and all other current web browsers. Note: in future releases of gif2png, the meaning of this switch may change to reflect the capabilities of prevalent browsers.

+The web\-probe switch is intended to be used with scripts for converting web sites. All PNGs generated from the pathnames it returns will be properly rendered in Netscape Navigator 4.04+, Internet Explorer versions 4.0b1+, and all other current web browsers. Note: in future releases of gif2png, the meaning of this switch may change to reflect the capabilities of prevalent browsers.

 .SH "PATENT ISSUES"

 .PP

-The GIF format is encumbered by a Unisys patent (see <: http://www.delphion.com/detailshttp://www.delphion.com/details?&pn10=US04464650>) for the Lempel-Ziv-Welch compression algorithm. Use of any GIF image generator not licensed by Unisys can make you liable to lawsuit. Unisys apparently refuses to issue licenses for use of LZW in open-source programs, and in 1999 stated that its policy is to require a $5000 fee from websites that carry GIF images made by unlicensed software -- even nonprofit websites created and displayed with free software. See <: http://corp2.unisys.com/LeadStory/lzw-license.htmlhttp://corp2.unisys.com/LeadStory/lzw-license.html> for details.

+The GIF format is encumbered by a Unisys patent (see <http://www.delphion.com/details?&pn10=US04464650>) for the Lempel\-Ziv\-Welch compression algorithm. Use of any GIF image generator not licensed by Unisys can make you liable to lawsuit. Unisys apparently refuses to issue licenses for use of LZW in open\-source programs, and in 1999 stated that its policy is to require a $5000 fee from websites that carry GIF images made by unlicensed software \-\- even nonprofit websites created and displayed with free software. See <http://corp2.unisys.com/LeadStory/lzw\-license.html> for details.

 .PP

-The patent probably does not cover LZW decompressors such as the one gif2png uses; legal opinions are divided on this, there has been no court test, and Unisys refuses to commit itself. It is possible that you may be liable if you distribute \fBgif2png\fR in a commercial program, or distribute \fBgif2png\fR on a for-profit basis.

+The patent probably does not cover LZW decompressors such as the one gif2png uses; legal opinions are divided on this, there has been no court test, and Unisys refuses to commit itself. It is possible that you may be liable if you distribute \fBgif2png\fR in a commercial program, or distribute \fBgif2png\fR on a for\-profit basis.

 .PP

-For a history of the GIF patent controversy, see <: http://lpf.ai.mit.edu/Patents/Gif/Gif.htmlhttp://lpf.ai.mit.edu/Patents/Gif/Gif.html>. To avoid legal problems, it would be a good idea to convert all GIFs on your websites and elsewhere to PNGs without delay. See <: http://burnallgifs.org/http://burnallgifs.org/> for discussion.

+For a history of the GIF patent controversy, see <http://lpf.ai.mit.edu/Patents/Gif/Gif.html>. To avoid legal problems, it would be a good idea to convert all GIFs on your websites and elsewhere to PNGs without delay. See <http://burnallgifs.org/> for discussion.

 .SH "STANDARDS AND SPECIFICATIONS"

@@ -136,7 +136,7 @@

 Copies of the GIF89 specification are widely available on the Web; search for "GRAPHICS INTERCHANGE FORMAT". The Graphics Interchange Format(c) is the Copyright property of CompuServe Incorporated. GIF(sm) is a Service Mark property of CompuServe Incorporated.

 .PP

-The PNG home site at <: http://www.libpng.org/pub/png/http://www.libpng.org/pub/png/> has very complete information on the PNG standard, PNG libraries, and PNG tools.

+The PNG home site at <http://www.libpng.org/pub/png/> has very complete information on the PNG standard, PNG libraries, and PNG tools.

 .SH "SEE ALSO"

@@ -146,5 +146,5 @@

 .SH "AUTHORS"

 .PP

-Code by Alexander Lehmann <alex@hal.rhein-main.de>, 1995. Auto-interlace conversion and tRNS optimization by Greg Roelofs <newt@pobox.com>, 1999. Man page, -O, -w, and production packaging by Eric S. Raymond <esr@thyrsus.com>, 1999.

+Code by Alexander Lehmann <alex@hal.rhein\-main.de>, 1995. Auto\-interlace conversion and tRNS optimization by Greg Roelofs <newt@pobox.com>, 1999. Man page, \-O, \-w, and production packaging by Eric S. Raymond <esr@thyrsus.com>, 1999.

diff -urNad gif2png-2.5.1~/web2png.1 gif2png-2.5.1/web2png.1

--- gif2png-2.5.1~/web2png.1	2003-12-26 22:10:52.000000000 +0100

+++ gif2png-2.5.1/web2png.1	2005-10-03 18:07:40.360635127 +0200

@@ -23,7 +23,7 @@

 .SH "SYNOPSIS"

 .nf

-\fBweb2png\fR [-adnrtv] [\fIdirectory\fR...]

+\fBweb2png\fR [\-adnrtv] [\fIdirectory\fR...]

 .fi

 .SH "DESCRIPTION"

@@ -38,39 +38,39 @@

 In each directory, \fBweb2png\fR tries to convert every GIF to a PNG. It leaves alone GIFs that have either multiple images or transparency, because these will not display properly in all current browsers. It also does not reconvert GIFs that already have corresponding PNGs (e.g. the same name except for the .gif file extension). The original GIFs are left in place.

 .PP

-Web2png tracks successful conversions. It then looks at each HTML, secure HTML, HTML inclusion, PHP page, JavaScript program or Cascading Style Sheet under the argument directories (extensions html, shtml, .inc, .php, .js, .css). In these pages, it fixes each reference to each successful converted GIF to point at the PNG. References in relative HREF and BACKGROUND tags are recognized by filename and fixed (any base directory declared by a BASE tag will be be prepended to the relative URL). References that are HTTP URLs are matched against the list of convertible GIFs by basename; if there is such a match, the contents of the URL is retrieved and compared to the convertible GIF. If both basename and data match, the HTTP reference is fixed. If the pages are under RCS version control, they're checked out for modification before being altered; otherwise, a copy of the original of each modified web page is left in the same directory, with the additional extension .bak.

+Web2png tracks successful conversions. It then looks at each HTML, secure HTML, HTML inclusion, PHP page, JavaScript program or Cascading Style Sheet under the argument directories (extensions .html, .shtml, .inc, .php, .js, .css). In these pages, it fixes each reference to each successful converted GIF to point at the PNG. References in relative HREF and BACKGROUND tags are recognized by filename and fixed (any base directory declared by a BASE tag will be prepended to the relative URL). References that are HTTP URLs are matched against the list of convertible GIFs by basename; if there is such a match, the contents of the URL is retrieved and compared to the convertible GIF. If both basename and data match, the HTTP reference is fixed. If the pages are under RCS version control, they're checked out for modification before being altered; otherwise, a copy of the original of each modified web page is left in the same directory, with the additional extension .bak.

 .PP

 The following options change the behavior of the program:

 .TP

-.nf \fB\fR .fi

+\fB\-a\fR

 Convert all GIF files, including those with multiple images and/or transparency.

 .TP

-.nf \fB\fR .fi

-Delete originals. Removes all GIFs with corresponding PNGs, and all .bak files.

+\fB\-d\fR

+Delete originals. Removes all GIFs with corresponding PNGs, and all .bak files. ATTENTION: Other options together with this one have no effect.

 .TP

-.nf \fB\fR .fi

+\fB\-n\fR

 Make no changes. With this option, \fBweb2png\fR reports on what needs to be done (and on GIFs that use transparency or have multiple images), but neither converts GIFs nor touches web pages.

 .TP

-.nf \fB\fR .fi

+\fB\-r\fR

 Reverse. Restore all HTML/SHTML/PHP pages from the .bak files created by a previous run (or, if the files were under version control, revert them). Remove PNGs with corresponding GIFs.

 .TP

-.nf \fB\fR .fi

+\fB\-t\fR

 Convert transparent GIFs (for use with IE 5.0+. Netscape 6.0+, and Mozilla).

 .TP

-.nf \fB\fR .fi

-Verbose. Utter more trace information about the conversion process. Web2png can be run on a directory that has already been partly converted by previous runs; it will do the minimum necessary amount of work. The changes it makes will be fully reversible with \fB-r\fR until you run it in \fB-d\fR mode. Web2png is written in Python. Python 1.5.2 or better must be installed and accessible on your system in order for \fBweb2png\fR to run.

+\fB\-v\fR

+Verbose. Utter more trace information about the conversion process. Web2png can be run on a directory that has already been partly converted by previous runs; it will do the minimum necessary amount of work. The changes it makes will be fully reversible with \fB\-r\fR until you run it in \fB\-d\fR mode. Web2png is written in Python. Python 1.5.2 or better must be installed and accessible on your system in order for \fBweb2png\fR to run.

 .SH "NOTE"

 .PP

-Sometimes it's possible to convert transparent GIFs without altering the appearance of the page, by knowing from context that they will always place within an area of fixed and solid color. Web2png can't deduce when this will be, so it doesn't try; but it may be useful to apply gif2png with the -b option by hand.

+Sometimes it's possible to convert transparent GIFs without altering the appearance of the page, by knowing from context that they will always place within an area of fixed and solid color. Web2png can't deduce when this will be, so it doesn't try; but it may be useful to apply gif2png with the \-b option by hand.

 .SH "KNOWN PROBLEMS"

@@ -78,10 +78,10 @@

 The algorithm for fixing HTTP URLs is not foolproof. It could be confused into incorrectly patching an HTTP URL reference to a GIF into an invalid reference to a PNG if the GIF matches a local target GIF by both basename and binary content, but actually lives on another host.

 .PP

-This program does not automatically convert CGIs; you'll have to do that by hand. Other dynamic-content methods (such as server-side inclusions) may also require hand-hacking.

+This program does not automatically convert CGIs; you'll have to do that by hand. Other dynamic\-content methods (such as server\-side inclusions) may also require hand\-hacking.

 .PP

-The program cannot tell converted from preexisting PNGs; if you have PNGs with the same stem name as corresponding GIFs but carrying different information, the \fB-r\fR mode will clobber them.

+The program cannot tell converted from preexisting PNGs; if you have PNGs with the same stem name as corresponding GIFs but carrying different information, the \fB\-r\fR mode will clobber them.

 .SH "SEE ALSO"

@@ -94,5 +94,5 @@

 Eric S. Raymond <esr@thyrsus.com>, October 1999.

 .PP

-Slightly modified for Debian by Aaron Isotton <aaron@isotton.com>.

+Slightly modified for Debian by Aaron Isotton <aaron@isotton.com> and Erik Schanze <schanzi_@gmx.de>.