[libpng17] Updated documentation to show default behavior of benign errors

correctly.
This commit is contained in:
Glenn Randers-Pehrson 2013-07-02 09:54:05 -05:00
parent 5aa2ca454d
commit fb411867b0
2 changed files with 24 additions and 12 deletions

View File

@ -1,6 +1,6 @@
libpng-manual.txt - A description on how to use and modify libpng libpng-manual.txt - A description on how to use and modify libpng
libpng version 1.7.0beta16 - June 18, 2013 libpng version 1.7.0beta16 - July 2, 2013
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
<glennrp at users.sourceforge.net> <glennrp at users.sourceforge.net>
Copyright (c) 1998-2013 Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson
@ -11,7 +11,7 @@ libpng-manual.txt - A description on how to use and modify libpng
Based on: Based on:
libpng versions 0.97, January 1998, through 1.7.0beta16 - June 18, 2013 libpng versions 0.97, January 1998, through 1.7.0beta16 - July 2, 2013
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2013 Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson
@ -4012,9 +4012,12 @@ as warnings.
png_set_benign_errors (png_ptr, int allowed); png_set_benign_errors (png_ptr, int allowed);
allowed: 0: (default) treat png_benign_error() an error. allowed: 0: treat png_benign_error() as an error.
1: treat png_benign_error() as a warning. 1: treat png_benign_error() as a warning.
As of libpng-1.6.0, the default condition is to treat benign errors as
warnings while reading and as errors while writing.
Custom chunks Custom chunks
If you need to read or write custom chunks, you may need to get deeper If you need to read or write custom chunks, you may need to get deeper
@ -5005,6 +5008,9 @@ is allowed to appear in images with any color type.
The library now issues an error if the application attempts to set a The library now issues an error if the application attempts to set a
transform after it calls png_read_update_info(). transform after it calls png_read_update_info().
The default condition for benign_errors is now to treat benign errors as
warnings while reading and as errors while writing.
The library now issues a warning if both background processing and RGB to The library now issues a warning if both background processing and RGB to
gray are used when gamma correction happens. As with previous versions of gray are used when gamma correction happens. As with previous versions of
the library the results are numerically very incorrect in this case. the library the results are numerically very incorrect in this case.
@ -5230,7 +5236,7 @@ Other rules can be inferred by inspecting the libpng source.
XVII. Y2K Compliance in libpng XVII. Y2K Compliance in libpng
June 18, 2013 July 2, 2013
Since the PNG Development group is an ad-hoc body, we can't make Since the PNG Development group is an ad-hoc body, we can't make
an official declaration. an official declaration.

View File

@ -1,4 +1,4 @@
.TH LIBPNG 3 "June 18, 2013" .TH LIBPNG 3 "July 2, 2013"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.7.0beta16 libpng \- Portable Network Graphics (PNG) Reference Library 1.7.0beta16
.SH SYNOPSIS .SH SYNOPSIS
@ -494,7 +494,7 @@ Following is a copy of the libpng-manual.txt file that accompanies libpng.
.SH LIBPNG.TXT .SH LIBPNG.TXT
libpng-manual.txt - A description on how to use and modify libpng libpng-manual.txt - A description on how to use and modify libpng
libpng version 1.7.0beta16 - June 18, 2013 libpng version 1.7.0beta16 - July 2, 2013
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
<glennrp at users.sourceforge.net> <glennrp at users.sourceforge.net>
Copyright (c) 1998-2013 Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson
@ -505,7 +505,7 @@ libpng-manual.txt - A description on how to use and modify libpng
Based on: Based on:
libpng versions 0.97, January 1998, through 1.7.0beta16 - June 18, 2013 libpng versions 0.97, January 1998, through 1.7.0beta16 - July 2, 2013
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2013 Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson
@ -4506,9 +4506,12 @@ as warnings.
png_set_benign_errors (png_ptr, int allowed); png_set_benign_errors (png_ptr, int allowed);
allowed: 0: (default) treat png_benign_error() an error. allowed: 0: treat png_benign_error() as an error.
1: treat png_benign_error() as a warning. 1: treat png_benign_error() as a warning.
As of libpng-1.6.0, the default condition is to treat benign errors as
warnings while reading and as errors while writing.
.SS Custom chunks .SS Custom chunks
If you need to read or write custom chunks, you may need to get deeper If you need to read or write custom chunks, you may need to get deeper
@ -5500,6 +5503,9 @@ is allowed to appear in images with any color type.
The library now issues an error if the application attempts to set a The library now issues an error if the application attempts to set a
transform after it calls png_read_update_info(). transform after it calls png_read_update_info().
The default condition for benign_errors is now to treat benign errors as
warnings while reading and as errors while writing.
The library now issues a warning if both background processing and RGB to The library now issues a warning if both background processing and RGB to
gray are used when gamma correction happens. As with previous versions of gray are used when gamma correction happens. As with previous versions of
the library the results are numerically very incorrect in this case. the library the results are numerically very incorrect in this case.
@ -5725,7 +5731,7 @@ Other rules can be inferred by inspecting the libpng source.
.SH XVII. Y2K Compliance in libpng .SH XVII. Y2K Compliance in libpng
June 18, 2013 July 2, 2013
Since the PNG Development group is an ad-hoc body, we can't make Since the PNG Development group is an ad-hoc body, we can't make
an official declaration. an official declaration.
@ -5995,7 +6001,7 @@ possible without all of you.
Thanks to Frank J. T. Wojcik for helping with the documentation. Thanks to Frank J. T. Wojcik for helping with the documentation.
Libpng version 1.7.0beta16 - June 18, 2013: Libpng version 1.7.0beta16 - July 2, 2013:
Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc. Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc.
Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net). Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net).
@ -6018,7 +6024,7 @@ this sentence.
This code is released under the libpng license. This code is released under the libpng license.
libpng versions 1.2.6, August 15, 2004, through 1.7.0beta16, June 18, 2013, are libpng versions 1.2.6, August 15, 2004, through 1.7.0beta16, July 2, 2013, are
Copyright (c) 2004,2006-2007 Glenn Randers-Pehrson, and are Copyright (c) 2004,2006-2007 Glenn Randers-Pehrson, and are
distributed according to the same disclaimer and license as libpng-1.2.5 distributed according to the same disclaimer and license as libpng-1.2.5
with the following individual added to the list of Contributing Authors with the following individual added to the list of Contributing Authors
@ -6117,7 +6123,7 @@ certification mark of the Open Source Initiative.
Glenn Randers-Pehrson Glenn Randers-Pehrson
glennrp at users.sourceforge.net glennrp at users.sourceforge.net
June 18, 2013 July 2, 2013
.\" end of man page .\" end of man page