From 5b40b01319fb85265512fbdccd40ba703b59cb5c Mon Sep 17 00:00:00 2001 From: Glenn Randers-Pehrson Date: Thu, 25 Nov 2010 07:16:29 -0600 Subject: [PATCH] [devel] Added a remark about png_get_uint_16 in the libpng-manual.txt and libpng.3 --- libpng-manual.txt | 25 ++++++++++++++++++------- libpng.3 | 33 ++++++++++++++++++++++----------- 2 files changed, 40 insertions(+), 18 deletions(-) diff --git a/libpng-manual.txt b/libpng-manual.txt index bce9f294e..1b1ea58cd 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.5.0beta56 - November 21, 2010 + libpng version 1.5.0beta56 - November 25, 2010 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2010 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.5.0beta56 - November 21, 2010 + libpng versions 0.97, January 1998, through 1.5.0beta56 - November 25, 2010 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2010 Glenn Randers-Pehrson @@ -3191,6 +3191,12 @@ deprecated since libpng-1.0.18 and 1.2.9, when it was replaced with png_set_expand_gray_1_2_4_to_8() because the former function also expanded palette images. +Macros for png_get_uint_16, png_get_uint_32, and png_get_int_32 +were added and are used by default instead of the corresponding +functions. Unfortunately, +from libpng-1.4.0 until 1.4.4, the png_get_uint_16 macro (but not the +function) incorrectly returned a value of type png_uint_32. + We changed the prototype for png_malloc() from png_malloc(png_structp png_ptr, png_uint_32 size) to @@ -3228,7 +3234,12 @@ PNG_QUANTIZE_[RED,GREEN,BLUE]_BITS. We removed the trailing '.' from the warning and error messages. -X. Detecting libpng +X. Changes to Libpng from version 1.4.x to 1.5.x + +From libpng-1.4.0 until 1.4.4, the png_get_uint_16 macro (but not the +function) incorrectly returned a value of type png_uint_32. + +XI. Detecting libpng The png_get_io_ptr() function has been present since libpng-0.88, has never changed, and is unaffected by conditional compilation macros. It is the @@ -3237,7 +3248,7 @@ libpng version since 0.88. In an autoconf "configure.in" you could use AC_CHECK_LIB(png, png_get_io_ptr, ... -XI. Source code repository +XII. Source code repository Since about February 2009, version 1.2.34, libpng has been under "git" source control. The git repository was built from old libpng-x.y.z.tar.gz files @@ -3256,7 +3267,7 @@ the libpng bug tracker at http://libpng.sourceforge.net -XII. Coding style +XIII. Coding style Our coding style is similar to the "Allman" style, with curly braces on separate lines: @@ -3364,9 +3375,9 @@ Lines do not exceed 80 characters. Other rules can be inferred by inspecting the libpng source. -XIII. Y2K Compliance in libpng +XIV. Y2K Compliance in libpng -November 21, 2010 +November 25, 2010 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 15371e094..b4ba4e37e 100644 --- a/libpng.3 +++ b/libpng.3 @@ -1,4 +1,4 @@ -.TH LIBPNG 3 "November 21, 2010" +.TH LIBPNG 3 "November 25, 2010" .SH NAME libpng \- Portable Network Graphics (PNG) Reference Library 1.5.0beta56 .SH SYNOPSIS @@ -851,7 +851,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.5.0beta56 - November 21, 2010 + libpng version 1.5.0beta56 - November 25, 2010 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2010 Glenn Randers-Pehrson @@ -862,7 +862,7 @@ libpng-manual.txt - A description on how to use and modify libpng Based on: - libpng versions 0.97, January 1998, through 1.5.0beta56 - November 21, 2010 + libpng versions 0.97, January 1998, through 1.5.0beta56 - November 25, 2010 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2010 Glenn Randers-Pehrson @@ -4042,6 +4042,12 @@ deprecated since libpng-1.0.18 and 1.2.9, when it was replaced with png_set_expand_gray_1_2_4_to_8() because the former function also expanded palette images. +Macros for png_get_uint_16, png_get_uint_32, and png_get_int_32 +were added and are used by default instead of the corresponding +functions. Unfortunately, +from libpng-1.4.0 until 1.4.4, the png_get_uint_16 macro (but not the +function) incorrectly returned a value of type png_uint_32. + We changed the prototype for png_malloc() from png_malloc(png_structp png_ptr, png_uint_32 size) to @@ -4079,7 +4085,12 @@ PNG_QUANTIZE_[RED,GREEN,BLUE]_BITS. We removed the trailing '.' from the warning and error messages. -.SH X. Detecting libpng +.SH X. Changes to Libpng from version 1.4.x to 1.5.x + +From libpng-1.4.0 until 1.4.4, the png_get_uint_16 macro (but not the +function) incorrectly returned a value of type png_uint_32. + +.SH XI. Detecting libpng The png_get_io_ptr() function has been present since libpng-0.88, has never changed, and is unaffected by conditional compilation macros. It is the @@ -4088,7 +4099,7 @@ libpng version since 0.88. In an autoconf "configure.in" you could use AC_CHECK_LIB(png, png_get_io_ptr, ... -.SH XI. Source code repository +.SH XII. Source code repository Since about February 2009, version 1.2.34, libpng has been under "git" source control. The git repository was built from old libpng-x.y.z.tar.gz files @@ -4107,7 +4118,7 @@ the libpng bug tracker at http://libpng.sourceforge.net -.SH XII. Coding style +.SH XIII. Coding style Our coding style is similar to the "Allman" style, with curly braces on separate lines: @@ -4215,9 +4226,9 @@ Lines do not exceed 80 characters. Other rules can be inferred by inspecting the libpng source. -.SH XIII. Y2K Compliance in libpng +.SH XIV. Y2K Compliance in libpng -November 21, 2010 +November 25, 2010 Since the PNG Development group is an ad-hoc body, we can't make an official declaration. @@ -4460,7 +4471,7 @@ possible without all of you. Thanks to Frank J. T. Wojcik for helping with the documentation. -Libpng version 1.5.0beta56 - November 21, 2010: +Libpng version 1.5.0beta56 - November 25, 2010: Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc. Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net). @@ -4483,7 +4494,7 @@ this sentence. This code is released under the libpng license. -libpng versions 1.2.6, August 15, 2004, through 1.5.0beta56, November 21, 2010, are +libpng versions 1.2.6, August 15, 2004, through 1.5.0beta56, November 25, 2010, 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 @@ -4582,7 +4593,7 @@ certification mark of the Open Source Initiative. Glenn Randers-Pehrson glennrp at users.sourceforge.net -November 21, 2010 +November 25, 2010 .\" end of man page