From f7a7bb0384c1e26082d06a05a28c279ce323ec00 Mon Sep 17 00:00:00 2001 From: Glenn Randers-Pehrson Date: Fri, 17 Oct 2014 09:06:25 -0500 Subject: [PATCH] [libpng16] Changed png_convert_to_rfc_1123() to png_convert_to_rfc_1123_buffer() in the manual, to reflect the change made in libpng-1.6.0. Updated README file to reflect that direct access to the info struct and png struct are not permitted since libpng-1.5.0. --- README | 16 +++++++++++----- libpng-manual.txt | 15 ++++++++------- libpng.3 | 25 +++++++++++++------------ 3 files changed, 32 insertions(+), 24 deletions(-) diff --git a/README b/README index c1de8c653..7e3017cc4 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -README for libpng version 1.6.14rc01 - October 15, 2014 (shared library 16.0) +README for libpng version 1.6.14rc02 - October 17, 2014 (shared library 16.0) See the note about version numbers near the top of png.h See INSTALL for instructions on how to install libpng. @@ -30,11 +30,17 @@ png_get_ functions. These functions should be used when accessing/storing the info_struct data, rather than manipulating it directly, to avoid such problems in the future. -It is important to note that the APIs do not make current programs +It is important to note that the APIs did not make current programs that access the info struct directly incompatible with the new -library. However, it is strongly suggested that new programs use -the new APIs (as shown in example.c and pngtest.c), and older programs -be converted to the new format, to facilitate upgrades in the future. +library, through libpng-1.2.x. In libpng-1.4.x, which was meant to +be a transitional release, the png struct and the info struct can still +be accessed, but the compiler will issue a warning about deprecated +usage. Since libpng-1.5.0, direct access to these structs is not +allowed, and the definitions of the structs reside in private +pngstruct.h and pnginfo.h header files that are not accessible to +applications. It is strongly suggested that new programs use the new +APIs (as shown in example.c and pngtest.c), and older programs be +converted to the new format, to facilitate upgrades in the future. **** Additions since 0.90 include the ability to compile libpng as a diff --git a/libpng-manual.txt b/libpng-manual.txt index af0d4a876..c292fb098 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.14rc01 - October 15, 2014 + libpng version 1.6.14rc02 - October 17, 2014 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2014 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.14rc01 - October 15, 2014 + libpng versions 0.97, January 1998, through 1.6.14rc02 - October 17, 2014 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2014 Glenn Randers-Pehrson @@ -3261,7 +3261,7 @@ tEXt chunk use RFC 1123 format dates (e.g. "22 May 1997 18:07:10 GMT"), although this isn't a requirement. Unlike the tIME chunk, the "Creation Time" tEXt chunk is not expected to be automatically changed by the software. To facilitate the use of RFC 1123 dates, a function -png_convert_to_rfc1123_buffer(png_ptr, buffer, png_timep) is provided to +png_convert_to_rfc1123_buffer(buffer, png_timep) is provided to convert from PNG time to an RFC 1123 format string. The caller must provide a writeable buffer of at least 29 bytes. @@ -5277,13 +5277,13 @@ Other rules can be inferred by inspecting the libpng source. XVI. Y2K Compliance in libpng -October 15, 2014 +October 17, 2014 Since the PNG Development group is an ad-hoc body, we can't make an official declaration. This is your unofficial assurance that libpng from version 0.71 and -upward through 1.6.14rc01 are Y2K compliant. It is my belief that earlier +upward through 1.6.14rc02 are Y2K compliant. It is my belief that earlier versions were also Y2K compliant. Libpng only has two year fields. One is a 2-byte unsigned integer @@ -5299,8 +5299,9 @@ in libpng-1.6.x and will be removed from libpng-1.7.0. There are seven time-related functions: - png_convert_to_rfc_1123() in png.c - (formerly png_convert_to_rfc_1152() in error) + png_convert_to_rfc_1123_buffer() in png.c + (formerly png_convert_to_rfc_1152() in error, and + also formerly png_convert_to_rfc_1123()) png_convert_from_struct_tm() in pngwrite.c, called in pngwrite.c png_convert_from_time_t() in pngwrite.c diff --git a/libpng.3 b/libpng.3 index 2a26d9632..7b8d27af4 100644 --- a/libpng.3 +++ b/libpng.3 @@ -1,6 +1,6 @@ -.TH LIBPNG 3 "October 15, 2014" +.TH LIBPNG 3 "October 17, 2014" .SH NAME -libpng \- Portable Network Graphics (PNG) Reference Library 1.6.14rc01 +libpng \- Portable Network Graphics (PNG) Reference Library 1.6.14rc02 .SH SYNOPSIS \fB #include \fP @@ -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.14rc01 - October 15, 2014 + libpng version 1.6.14rc02 - October 17, 2014 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2014 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.14rc01 - October 15, 2014 + libpng versions 0.97, January 1998, through 1.6.14rc02 - October 17, 2014 Updated and distributed by Glenn Randers-Pehrson Copyright (c) 1998-2014 Glenn Randers-Pehrson @@ -3765,7 +3765,7 @@ tEXt chunk use RFC 1123 format dates (e.g. "22 May 1997 18:07:10 GMT"), although this isn't a requirement. Unlike the tIME chunk, the "Creation Time" tEXt chunk is not expected to be automatically changed by the software. To facilitate the use of RFC 1123 dates, a function -png_convert_to_rfc1123_buffer(png_ptr, buffer, png_timep) is provided to +png_convert_to_rfc1123_buffer(buffer, png_timep) is provided to convert from PNG time to an RFC 1123 format string. The caller must provide a writeable buffer of at least 29 bytes. @@ -5781,13 +5781,13 @@ Other rules can be inferred by inspecting the libpng source. .SH XVI. Y2K Compliance in libpng -October 15, 2014 +October 17, 2014 Since the PNG Development group is an ad-hoc body, we can't make an official declaration. This is your unofficial assurance that libpng from version 0.71 and -upward through 1.6.14rc01 are Y2K compliant. It is my belief that earlier +upward through 1.6.14rc02 are Y2K compliant. It is my belief that earlier versions were also Y2K compliant. Libpng only has two year fields. One is a 2-byte unsigned integer @@ -5803,8 +5803,9 @@ in libpng-1.6.x and will be removed from libpng-1.7.0. There are seven time-related functions: - png_convert_to_rfc_1123() in png.c - (formerly png_convert_to_rfc_1152() in error) + png_convert_to_rfc_1123_buffer() in png.c + (formerly png_convert_to_rfc_1152() in error, and + also formerly png_convert_to_rfc_1123()) png_convert_from_struct_tm() in pngwrite.c, called in pngwrite.c png_convert_from_time_t() in pngwrite.c @@ -6087,7 +6088,7 @@ possible without all of you. Thanks to Frank J. T. Wojcik for helping with the documentation. -Libpng version 1.6.14rc01 - October 15, 2014: +Libpng version 1.6.14rc02 - October 17, 2014: Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc. Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net). @@ -6110,7 +6111,7 @@ this sentence. This code is released under the libpng license. -libpng versions 1.2.6, August 15, 2004, through 1.6.14rc01, October 15, 2014, are +libpng versions 1.2.6, August 15, 2004, through 1.6.14rc02, October 17, 2014, are Copyright (c) 2004,2006-2014 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 @@ -6209,7 +6210,7 @@ certification mark of the Open Source Initiative. Glenn Randers-Pehrson glennrp at users.sourceforge.net -October 15, 2014 +October 17, 2014 .\" end of man page