[libpng15] Minor edit of documentation

This commit is contained in:
Glenn Randers-Pehrson 2012-10-10 14:58:41 -05:00
parent 1badb47dc3
commit 33b90debc5
3 changed files with 30 additions and 525 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.5.14beta01 - September 27, 2012 libpng version 1.5.14beta01 - October 10, 2012
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-2012 Glenn Randers-Pehrson Copyright (c) 1998-2012 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.5.14beta01 - September 27, 2012 libpng versions 0.97, January 1998, through 1.5.14beta01 - October 10, 2012
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2012 Glenn Randers-Pehrson Copyright (c) 1998-2012 Glenn Randers-Pehrson
@ -48,7 +48,7 @@ of reducing the amount of time and effort it takes to support the PNG
file format in application programs. file format in application programs.
The PNG specification (second edition), November 2003, is available as The PNG specification (second edition), November 2003, is available as
a W3C Recommendation and as an ISO Standard (ISO/IEC 15948:2003 (E)) at a W3C Recommendation and as an ISO Standard (ISO/IEC 15948:2004 (E)) at
<http://www.w3.org/TR/2003/REC-PNG-20031110/ <http://www.w3.org/TR/2003/REC-PNG-20031110/
The W3C and ISO documents have identical technical content. The W3C and ISO documents have identical technical content.
@ -4581,7 +4581,7 @@ pngtest) appear in
pngpriv.h pngpriv.h
above the comment that says above the comment that says
/* Maintainer: Put new private prototypes here ^ and in libpngpf.3 */ /* Maintainer: Put new private prototypes here ^ */
To avoid polluting the global namespace, the names of all exported To avoid polluting the global namespace, the names of all exported
functions and variables begin with "png_", and all publicly visible C functions and variables begin with "png_", and all publicly visible C
@ -4598,7 +4598,7 @@ left parenthesis that follows it:
for (i = 2; i > 0; --i) for (i = 2; i > 0; --i)
y[i] = a(x) + (int)b; y[i] = a(x) + (int)b;
We prefer #ifdef and #ifndef to #if defined() and if !defined() We prefer #ifdef and #ifndef to #if defined() and #if !defined()
when there is only one macro being tested. when there is only one macro being tested.
We prefer to express integers that are used as bit masks in hex format, We prefer to express integers that are used as bit masks in hex format,
@ -4612,7 +4612,7 @@ Other rules can be inferred by inspecting the libpng source.
XIV. Y2K Compliance in libpng XIV. Y2K Compliance in libpng
September 27, 2012 October 10, 2012
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.

535
libpng.3

File diff suppressed because it is too large Load Diff

View File

@ -1583,14 +1583,14 @@ PNG_EXTERN void png_ascii_from_fixed PNGARG((png_structp png_ptr,
#define PNG_FP_IS_POSITIVE(state) (((state) & PNG_FP_NZ_MASK) == PNG_FP_Z_MASK) #define PNG_FP_IS_POSITIVE(state) (((state) & PNG_FP_NZ_MASK) == PNG_FP_Z_MASK)
#define PNG_FP_IS_NEGATIVE(state) (((state) & PNG_FP_NZ_MASK) == PNG_FP_NZ_MASK) #define PNG_FP_IS_NEGATIVE(state) (((state) & PNG_FP_NZ_MASK) == PNG_FP_NZ_MASK)
/* The actual parser. This can be called repeatedly, it updates /* The actual parser. This can be called repeatedly. It updates
* the index into the string and the state variable (which must * the index into the string and the state variable (which must
* be initialzed to 0). It returns a result code, as above. There * be initialized to 0). It returns a result code, as above. There
* is no point calling the parser any more if it fails to advance to * is no point calling the parser any more if it fails to advance to
* the end of the string - it is stuck on an invalid character (or * the end of the string - it is stuck on an invalid character (or
* terminated by '\0'). * terminated by '\0').
* *
* Note that the pointer will consume an E or even an E+ then leave * Note that the pointer will consume an E or even an E+ and then leave
* a 'maybe' state even though a preceding integer.fraction is valid. * a 'maybe' state even though a preceding integer.fraction is valid.
* The PNG_FP_WAS_VALID flag indicates that a preceding substring was * The PNG_FP_WAS_VALID flag indicates that a preceding substring was
* a valid number. It's possible to recover from this by calling * a valid number. It's possible to recover from this by calling
@ -1664,7 +1664,7 @@ PNG_EXTERN void png_build_gamma_table PNGARG((png_structp png_ptr,
int bit_depth)); int bit_depth));
#endif #endif
/* Maintainer: Put new private prototypes here ^ and in libpngpf.3 */ /* Maintainer: Put new private prototypes here ^ */
#include "pngdebug.h" #include "pngdebug.h"