From 52083f9152893a972cd11e8a4d0258d279d0511a Mon Sep 17 00:00:00 2001 From: Glenn Randers-Pehrson Date: Sat, 17 Aug 2013 15:44:37 -0500 Subject: [PATCH] [libpng16] Mention png_set_option() in the documentation. --- libpng-manual.txt | 19 +++++++++++++------ libpng.3 | 27 +++++++++++++++++---------- 2 files changed, 30 insertions(+), 16 deletions(-) diff --git a/libpng-manual.txt b/libpng-manual.txt index 0547652f3..0512515da 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.4beta01 - August 6, 2013 + libpng version 1.6.4beta01 - August 17, 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.4beta01 - August 6, 2013 + libpng versions 0.97, January 1998, through 1.6.4beta01 - August 17, 2013 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson @@ -4753,7 +4753,7 @@ did not exist.) Applications can now choose whether to use these macros or to call the corresponding function by defining PNG_USE_READ_MACROS or PNG_NO_USE_READ_MACROS before including png.h. Notice that this is -only supported from 1.5.0 -defining PNG_NO_USE_READ_MACROS prior to 1.5.0 +only supported from 1.5.0; defining PNG_NO_USE_READ_MACROS prior to 1.5.0 will lead to a link failure. Prior to libpng-1.5.4, the zlib compressor used the same set of parameters @@ -4789,6 +4789,9 @@ limits are now png_user_chunk_cache_max 0 (unlimited) 128 png_user_chunk_malloc_max 0 (unlimited) 8,000,000 +The png_set_option() function (and the "options" member of the png struct) was +added to libpng-1.5.15. + B. Changes to the build and configuration of libpng Details of internal changes to the library code can be found in the CHANGES @@ -5051,8 +5054,12 @@ to set the size of the sliding window for reading instead of using the default files in the wild that have incorrect CMF bytes that cause libpng to now issue a "too far back" error and reject the file. Libpng-1.6.3 provides a way to revert to the libpng-1.5.x behavior (ignoring the CMF bytes and using a -32-kbyte sliding window), and provides a tool -(contrib/tools/png-fix-too-far-back) for optimizing the CMF bytes +32-kbyte sliding window), by using + + png_set_option(png_ptr, PNG_MAXIMUM_INFLATE_WINDOW, + PNG_OPTION_ON); + +and provides a tool (contrib/tools/png-fix-too-far-back) for optimizing the CMF bytes correctly. Libpng-1.6.0 and libpng-1.6.1 wrote uncompressed iTXt chunks with the wrong @@ -5222,7 +5229,7 @@ Other rules can be inferred by inspecting the libpng source. XVI. Y2K Compliance in libpng -August 6, 2013 +August 17, 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 064bf4c74..6fdb567cf 100644 --- a/libpng.3 +++ b/libpng.3 @@ -1,4 +1,4 @@ -.TH LIBPNG 3 "August 6, 2013" +.TH LIBPNG 3 "August 17, 2013" .SH NAME libpng \- Portable Network Graphics (PNG) Reference Library 1.6.4beta01 .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.4beta01 - August 6, 2013 + libpng version 1.6.4beta01 - August 17, 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.4beta01 - August 6, 2013 + libpng versions 0.97, January 1998, through 1.6.4beta01 - August 17, 2013 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2013 Glenn Randers-Pehrson @@ -5258,7 +5258,7 @@ did not exist.) Applications can now choose whether to use these macros or to call the corresponding function by defining PNG_USE_READ_MACROS or PNG_NO_USE_READ_MACROS before including png.h. Notice that this is -only supported from 1.5.0 -defining PNG_NO_USE_READ_MACROS prior to 1.5.0 +only supported from 1.5.0; defining PNG_NO_USE_READ_MACROS prior to 1.5.0 will lead to a link failure. Prior to libpng-1.5.4, the zlib compressor used the same set of parameters @@ -5294,6 +5294,9 @@ limits are now png_user_chunk_cache_max 0 (unlimited) 128 png_user_chunk_malloc_max 0 (unlimited) 8,000,000 +The png_set_option() function (and the "options" member of the png struct) was +added to libpng-1.5.15. + B. Changes to the build and configuration of libpng Details of internal changes to the library code can be found in the CHANGES @@ -5556,8 +5559,12 @@ to set the size of the sliding window for reading instead of using the default files in the wild that have incorrect CMF bytes that cause libpng to now issue a "too far back" error and reject the file. Libpng-1.6.3 provides a way to revert to the libpng-1.5.x behavior (ignoring the CMF bytes and using a -32-kbyte sliding window), and provides a tool -(contrib/tools/png-fix-too-far-back) for optimizing the CMF bytes +32-kbyte sliding window), by using + + png_set_option(png_ptr, PNG_MAXIMUM_INFLATE_WINDOW, + PNG_OPTION_ON); + +and provides a tool (contrib/tools/png-fix-too-far-back) for optimizing the CMF bytes correctly. Libpng-1.6.0 and libpng-1.6.1 wrote uncompressed iTXt chunks with the wrong @@ -5727,7 +5734,7 @@ Other rules can be inferred by inspecting the libpng source. .SH XVI. Y2K Compliance in libpng -August 6, 2013 +August 17, 2013 Since the PNG Development group is an ad-hoc body, we can't make an official declaration. @@ -6007,7 +6014,7 @@ possible without all of you. Thanks to Frank J. T. Wojcik for helping with the documentation. -Libpng version 1.6.4beta01 - August 6, 2013: +Libpng version 1.6.4beta01 - August 17, 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). @@ -6030,7 +6037,7 @@ this sentence. This code is released under the libpng license. -libpng versions 1.2.6, August 15, 2004, through 1.6.4beta01, August 6, 2013, are +libpng versions 1.2.6, August 15, 2004, through 1.6.4beta01, August 17, 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 @@ -6129,7 +6136,7 @@ certification mark of the Open Source Initiative. Glenn Randers-Pehrson glennrp at users.sourceforge.net -August 6, 2013 +August 17, 2013 .\" end of man page