mewin/libpng
1
0
Fork 0
mirror of https://git.code.sf.net/p/libpng/code.git synced 2025-07-10 18:04:09 +02:00
Code Issues Projects Releases Wiki Activity

[libpng16] Minor documentation edits

Browse Source
This commit is contained in:
Glenn Randers-Pehrson 2012-10-10 15:02:00 -05:00
parent e15b1e8136
commit a9f44be8c2
3 changed files with 32 additions and 539 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
libpng-manual.txt
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.6.0beta30 - September 4, 2012 libpng version 1.6.0beta30 - 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-2011 Glenn Randers-Pehrson Copyright (c) 1998-2011 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.6.0beta30 - September 4, 2012 libpng versions 0.97, January 1998, through 1.6.0beta30 - October 10, 2012
Updated and distributed by Glenn Randers-Pehrson Updated and distributed by Glenn Randers-Pehrson
Copyright (c) 1998-2011 Glenn Randers-Pehrson Copyright (c) 1998-2011 Glenn Randers-Pehrson
@ -67,7 +67,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.
@ -5019,7 +5019,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 ^ */
We put a space after the "sizeof" operator and we omit the We put a space after the "sizeof" operator and we omit the
optional parentheses around its argument when the argument optional parentheses around its argument when the argument
@ -5033,7 +5033,7 @@ Prior to libpng-1.6.0 we used a "png_sizeof()" macro, formatted as
though it were a function. though it were a function.
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
preprocessor macros begin with "PNG". We request that applications that preprocessor macros begin with "PNG". We request that applications that
use libpng *not* begin any of their own symbols with either of these strings. use libpng *not* begin any of their own symbols with either of these strings.
@ -5047,7 +5047,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,
@ -5064,7 +5064,7 @@ Other rules can be inferred by inspecting the libpng source.
XVI. Y2K Compliance in libpng XVI. Y2K Compliance in libpng
September 4, 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.

549
libpng.3
View File

File diff suppressed because it is too large Load Diff

8
pngpriv.h
View File

@ -1694,14 +1694,14 @@ PNG_INTERNAL_FUNCTION(void,png_ascii_from_fixed,(png_const_structrp 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
@ -1839,7 +1839,7 @@ PNG_INTERNAL_FUNCTION(void, png_image_free, (png_imagep image), PNG_EMPTY);
#endif /* SIMPLIFIED READ/WRITE */ #endif /* SIMPLIFIED READ/WRITE */
/* Maintainer: Put new private prototypes here ^ and in libpngpf.3 */ /* Maintainer: Put new private prototypes here ^ */
#include "pngdebug.h" #include "pngdebug.h"