From d5dd93f5d1a6c411f75501a122ac2d32d5956b24 Mon Sep 17 00:00:00 2001 From: Glenn Randers-Pehrson Date: Tue, 2 Jul 2013 09:20:36 -0500 Subject: [PATCH] [libpng16] Updated documentation to show default behavior of benign errors correctly. --- ANNOUNCE | 5 +++-- CHANGES | 3 ++- libpng-manual.txt | 14 ++++++++++---- libpng.3 | 22 ++++++++++++++-------- 4 files changed, 29 insertions(+), 15 deletions(-) diff --git a/ANNOUNCE b/ANNOUNCE index be2510a48..9b25880d5 100644 --- a/ANNOUNCE +++ b/ANNOUNCE @@ -1,5 +1,5 @@ -Libpng 1.6.3beta10 - June 28, 2013 +Libpng 1.6.3beta10 - July 2, 2013 This is not intended to be a public release. It will be replaced within a few weeks by a public version or by another test version. @@ -112,7 +112,8 @@ Version 1.6.3beta09 [June 27, 2013] Renamed contrib/tools/png-fix-too-far-back.c to pngfix.c and revised it to check all compressed chunks known to libpng. -Version 1.6.3beta10 [June 28, 2013] +Version 1.6.3beta10 [July 2, 2013] + Updated documentation to show default behavior of benign errors correctly. Send comments/corrections/commendations to png-mng-implement at lists.sf.net (subscription required; visit diff --git a/CHANGES b/CHANGES index e0d9c36bc..99d0413a0 100644 --- a/CHANGES +++ b/CHANGES @@ -4596,7 +4596,8 @@ Version 1.6.3beta09 [June 27, 2013] Renamed contrib/tools/png-fix-too-far-back.c to pngfix.c and revised it to check all compressed chunks known to libpng. -Version 1.6.3beta10 [June 28, 2013] +Version 1.6.3beta10 [July 2, 2013] + Updated documentation to show default behavior of benign errors correctly. Send comments/corrections/commendations to png-mng-implement at lists.sf.net (subscription required; visit diff --git a/libpng-manual.txt b/libpng-manual.txt index 62f7f8180..8ec213090 100644 --- a/libpng-manual.txt +++ b/libpng-manual.txt @@ -1,6 +1,6 @@ libpng-manual.txt - A description on how to use and modify libpng - libpng version 1.6.3beta10 - June 28, 2013 + libpng version 1.6.3beta10 - July 2, 2013 Updated and distributed by 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: - libpng versions 0.97, January 1998, through 1.6.3beta10 - June 28, 2013 + libpng versions 0.97, January 1998, through 1.6.3beta10 - July 2, 2013 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson @@ -4026,9 +4026,12 @@ as warnings. 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. +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 If you need to read or write custom chunks, you may need to get deeper @@ -5019,6 +5022,9 @@ is allowed to appear in images with any color type. The library now issues an error if the application attempts to set a 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 gray are used when gamma correction happens. As with previous versions of the library the results are numerically very incorrect in this case. @@ -5212,7 +5218,7 @@ Other rules can be inferred by inspecting the libpng source. XVI. Y2K Compliance in libpng -June 28, 2013 +July 2, 2013 Since the PNG Development group is an ad-hoc body, we can't make an official declaration. diff --git a/libpng.3 b/libpng.3 index 217756d15..75e04450f 100644 --- a/libpng.3 +++ b/libpng.3 @@ -1,4 +1,4 @@ -.TH LIBPNG 3 "June 28, 2013" +.TH LIBPNG 3 "July 2, 2013" .SH NAME libpng \- Portable Network Graphics (PNG) Reference Library 1.6.3beta10 .SH SYNOPSIS @@ -504,7 +504,7 @@ Following is a copy of the libpng-manual.txt file that accompanies libpng. .SH LIBPNG.TXT libpng-manual.txt - A description on how to use and modify libpng - libpng version 1.6.3beta10 - June 28, 2013 + libpng version 1.6.3beta10 - July 2, 2013 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson @@ -515,7 +515,7 @@ libpng-manual.txt - A description on how to use and modify libpng Based on: - libpng versions 0.97, January 1998, through 1.6.3beta10 - June 28, 2013 + libpng versions 0.97, January 1998, through 1.6.3beta10 - July 2, 2013 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson @@ -4530,9 +4530,12 @@ as warnings. 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. +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 If you need to read or write custom chunks, you may need to get deeper @@ -5524,6 +5527,9 @@ is allowed to appear in images with any color type. The library now issues an error if the application attempts to set a 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 gray are used when gamma correction happens. As with previous versions of the library the results are numerically very incorrect in this case. @@ -5717,7 +5723,7 @@ Other rules can be inferred by inspecting the libpng source. .SH XVI. Y2K Compliance in libpng -June 28, 2013 +July 2, 2013 Since the PNG Development group is an ad-hoc body, we can't make an official declaration. @@ -5994,7 +6000,7 @@ possible without all of you. Thanks to Frank J. T. Wojcik for helping with the documentation. -Libpng version 1.6.3beta10 - June 28, 2013: +Libpng version 1.6.3beta10 - July 2, 2013: Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc. Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net). @@ -6017,7 +6023,7 @@ this sentence. This code is released under the libpng license. -libpng versions 1.2.6, August 15, 2004, through 1.6.3beta10, June 28, 2013, are +libpng versions 1.2.6, August 15, 2004, through 1.6.3beta10, July 2, 2013, are Copyright (c) 2004,2006-2007 Glenn Randers-Pehrson, and are distributed according to the same disclaimer and license as libpng-1.2.5 with the following individual added to the list of Contributing Authors @@ -6116,7 +6122,7 @@ certification mark of the Open Source Initiative. Glenn Randers-Pehrson glennrp at users.sourceforge.net -June 28, 2013 +July 2, 2013 .\" end of man page