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

[libpng15] Fixed grammar and typos in manual and in scripts/pnglibconf.dfa

Browse Source
This commit is contained in:
Glenn Randers-Pehrson 2012-06-09 10:42:43 -05:00
parent 613dd05c55
commit 83b354ac01
3 changed files with 31 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
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.5.11rc06 - June 7, 2012 libpng version 1.5.11rc06 - June 9, 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.5.11rc06 - June 7, 2012 libpng versions 0.97, January 1998, through 1.5.11rc06 - June 9, 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
@ -141,8 +141,8 @@ APIs. Most of these are fairly obvious; for example types corresponding
to integers of particular sizes and types for passing color values. to integers of particular sizes and types for passing color values.
One exception is how non-integral numbers are handled. For application One exception is how non-integral numbers are handled. For application
convenience most APIs that take such numbers have C (double) arguments, convenience most APIs that take such numbers have C (double) arguments;
however internally PNG, and libpng, use 32 bit signed integers and encode however, internally PNG, and libpng, use 32 bit signed integers and encode
the value by multiplying by 100,000. As of libpng 1.5.0 a convenience the value by multiplying by 100,000. As of libpng 1.5.0 a convenience
macro PNG_FP_1 is defined in png.h along with a type (png_fixed_point) macro PNG_FP_1 is defined in png.h along with a type (png_fixed_point)
which is simply (png_int_32). which is simply (png_int_32).
@ -1738,7 +1738,7 @@ the current display (e.g., the background color from a web page). You
need to tell libpng how the color is represented, both the format of the need to tell libpng how the color is represented, both the format of the
component values in the color (the number of bits) and the gamma encoding of the component values in the color (the number of bits) and the gamma encoding of the
color. The function takes two arguments, background_gamma_mode and need_expand color. The function takes two arguments, background_gamma_mode and need_expand
to convey this information, however only two combinations are likely to be to convey this information; however, only two combinations are likely to be
useful: useful:
png_color_16 my_background; png_color_16 my_background;
@ -2032,7 +2032,7 @@ the second parameter NULL.
If you don't want libpng to handle the interlacing details, just call If you don't want libpng to handle the interlacing details, just call
png_read_rows() PNG_INTERLACE_ADAM7_PASSES times to read in all the images. png_read_rows() PNG_INTERLACE_ADAM7_PASSES times to read in all the images.
Each of the images is a valid image by itself, however you will almost Each of the images is a valid image by itself; however, you will almost
certainly need to distribute the pixels from each sub-image to the certainly need to distribute the pixels from each sub-image to the
correct place. This is where everything gets very tricky. correct place. This is where everything gets very tricky.
@ -3690,7 +3690,7 @@ available to set these separately for non-IDAT
compressed chunks such as zTXt, iTXt, and iCCP: compressed chunks such as zTXt, iTXt, and iCCP:
#include zlib.h #include zlib.h
#if PNG_LIBPNG_VER <= 10504 #if PNG_LIBPNG_VER >= 10504
png_set_text_compression_level(png_ptr, level); png_set_text_compression_level(png_ptr, level);
png_set_text_compression_mem_level(png_ptr, level); png_set_text_compression_mem_level(png_ptr, level);
@ -4160,7 +4160,7 @@ This is enabled by default but can be disabled in each png_ptr with
A. Changes that affect users of libpng A. Changes that affect users of libpng
There are no substantial API changes between the non-deprecated parts of There are no substantial API changes between the non-deprecated parts of
the 1.4.5 API and the 1.5.0 API, however the ability to directly access the 1.4.5 API and the 1.5.0 API; however, the ability to directly access
the main libpng control structures, png_struct and png_info, deprecated the main libpng control structures, png_struct and png_info, deprecated
in earlier versions of libpng, has been completely removed from in earlier versions of libpng, has been completely removed from
libpng 1.5. libpng 1.5.
@ -4293,12 +4293,12 @@ B. Changes to the build and configuration of libpng
Details of internal changes to the library code can be found in the CHANGES Details of internal changes to the library code can be found in the CHANGES
file and in the GIT repository logs. These will be of no concern to the vast file and in the GIT repository logs. These will be of no concern to the vast
majority of library users or builders, however the few who configure libpng majority of library users or builders; however, the few who configure libpng
to a non-default feature set may need to change how this is done. to a non-default feature set may need to change how this is done.
There should be no need for library builders to alter build scripts if There should be no need for library builders to alter build scripts if
these use the distributed build support - configure or the makefiles - these use the distributed build support - configure or the makefiles -
however users of the makefiles may care to update their build scripts however, users of the makefiles may care to update their build scripts
to build pnglibconf.h where the corresponding makefile does not do so. to build pnglibconf.h where the corresponding makefile does not do so.
Building libpng with a non-default configuration has changed completely. Building libpng with a non-default configuration has changed completely.
@ -4404,7 +4404,7 @@ merely stops the function from being exported.
PNG_FLOATING_ARITHMETIC_SUPPORTED chooses between the internal floating PNG_FLOATING_ARITHMETIC_SUPPORTED chooses between the internal floating
point implementation or the fixed point one. Typically the fixed point point implementation or the fixed point one. Typically the fixed point
implementation is larger and slower than the floating point implementation implementation is larger and slower than the floating point implementation
on a system that supports floating point, however it may be faster on a on a system that supports floating point; however, it may be faster on a
system which lacks floating point hardware and therefore uses a software system which lacks floating point hardware and therefore uses a software
emulation. emulation.
@ -4433,7 +4433,7 @@ pngconf.h no longer includes pngusr.h, therefore pngusr.h is ignored after the
build of pnglibconf.h and it is never included in an application build. build of pnglibconf.h and it is never included in an application build.
The rarely used alternative of adding a list of feature macros to the The rarely used alternative of adding a list of feature macros to the
CFLAGS setting in the build also still works, however the macros will be CFLAGS setting in the build also still works; however, the macros will be
copied to pnglibconf.h and this may produce macro redefinition warnings copied to pnglibconf.h and this may produce macro redefinition warnings
when the individual C files are compiled. when the individual C files are compiled.
@ -4602,7 +4602,7 @@ Other rules can be inferred by inspecting the libpng source.
XIV. Y2K Compliance in libpng XIV. Y2K Compliance in libpng
June 7, 2012 June 9, 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.

34
libpng.3
View File

@ -1,4 +1,4 @@
.TH LIBPNG 3 "June 7, 2012" .TH LIBPNG 3 "June 9, 2012"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.5.11rc06 libpng \- Portable Network Graphics (PNG) Reference Library 1.5.11rc06
.SH SYNOPSIS .SH SYNOPSIS
@ -981,7 +981,7 @@ Following is a copy of the libpng-manual.txt file that accompanies libpng.
.SH LIBPNG.TXT .SH LIBPNG.TXT
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.11rc06 - June 7, 2012 libpng version 1.5.11rc06 - June 9, 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
@ -992,7 +992,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.11rc06 - June 7, 2012 libpng versions 0.97, January 1998, through 1.5.11rc06 - June 9, 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
@ -1122,8 +1122,8 @@ APIs. Most of these are fairly obvious; for example types corresponding
to integers of particular sizes and types for passing color values. to integers of particular sizes and types for passing color values.
One exception is how non-integral numbers are handled. For application One exception is how non-integral numbers are handled. For application
convenience most APIs that take such numbers have C (double) arguments, convenience most APIs that take such numbers have C (double) arguments;
however internally PNG, and libpng, use 32 bit signed integers and encode however, internally PNG, and libpng, use 32 bit signed integers and encode
the value by multiplying by 100,000. As of libpng 1.5.0 a convenience the value by multiplying by 100,000. As of libpng 1.5.0 a convenience
macro PNG_FP_1 is defined in png.h along with a type (png_fixed_point) macro PNG_FP_1 is defined in png.h along with a type (png_fixed_point)
which is simply (png_int_32). which is simply (png_int_32).
@ -2719,7 +2719,7 @@ the current display (e.g., the background color from a web page). You
need to tell libpng how the color is represented, both the format of the need to tell libpng how the color is represented, both the format of the
component values in the color (the number of bits) and the gamma encoding of the component values in the color (the number of bits) and the gamma encoding of the
color. The function takes two arguments, background_gamma_mode and need_expand color. The function takes two arguments, background_gamma_mode and need_expand
to convey this information, however only two combinations are likely to be to convey this information; however, only two combinations are likely to be
useful: useful:
png_color_16 my_background; png_color_16 my_background;
@ -3013,7 +3013,7 @@ the second parameter NULL.
If you don't want libpng to handle the interlacing details, just call If you don't want libpng to handle the interlacing details, just call
png_read_rows() PNG_INTERLACE_ADAM7_PASSES times to read in all the images. png_read_rows() PNG_INTERLACE_ADAM7_PASSES times to read in all the images.
Each of the images is a valid image by itself, however you will almost Each of the images is a valid image by itself; however, you will almost
certainly need to distribute the pixels from each sub-image to the certainly need to distribute the pixels from each sub-image to the
correct place. This is where everything gets very tricky. correct place. This is where everything gets very tricky.
@ -4672,7 +4672,7 @@ available to set these separately for non-IDAT
compressed chunks such as zTXt, iTXt, and iCCP: compressed chunks such as zTXt, iTXt, and iCCP:
#include zlib.h #include zlib.h
#if PNG_LIBPNG_VER <= 10504 #if PNG_LIBPNG_VER >= 10504
png_set_text_compression_level(png_ptr, level); png_set_text_compression_level(png_ptr, level);
png_set_text_compression_mem_level(png_ptr, level); png_set_text_compression_mem_level(png_ptr, level);
@ -5142,7 +5142,7 @@ This is enabled by default but can be disabled in each png_ptr with
A. Changes that affect users of libpng A. Changes that affect users of libpng
There are no substantial API changes between the non-deprecated parts of There are no substantial API changes between the non-deprecated parts of
the 1.4.5 API and the 1.5.0 API, however the ability to directly access the 1.4.5 API and the 1.5.0 API; however, the ability to directly access
the main libpng control structures, png_struct and png_info, deprecated the main libpng control structures, png_struct and png_info, deprecated
in earlier versions of libpng, has been completely removed from in earlier versions of libpng, has been completely removed from
libpng 1.5. libpng 1.5.
@ -5275,12 +5275,12 @@ B. Changes to the build and configuration of libpng
Details of internal changes to the library code can be found in the CHANGES Details of internal changes to the library code can be found in the CHANGES
file and in the GIT repository logs. These will be of no concern to the vast file and in the GIT repository logs. These will be of no concern to the vast
majority of library users or builders, however the few who configure libpng majority of library users or builders; however, the few who configure libpng
to a non-default feature set may need to change how this is done. to a non-default feature set may need to change how this is done.
There should be no need for library builders to alter build scripts if There should be no need for library builders to alter build scripts if
these use the distributed build support - configure or the makefiles - these use the distributed build support - configure or the makefiles -
however users of the makefiles may care to update their build scripts however, users of the makefiles may care to update their build scripts
to build pnglibconf.h where the corresponding makefile does not do so. to build pnglibconf.h where the corresponding makefile does not do so.
Building libpng with a non-default configuration has changed completely. Building libpng with a non-default configuration has changed completely.
@ -5386,7 +5386,7 @@ merely stops the function from being exported.
PNG_FLOATING_ARITHMETIC_SUPPORTED chooses between the internal floating PNG_FLOATING_ARITHMETIC_SUPPORTED chooses between the internal floating
point implementation or the fixed point one. Typically the fixed point point implementation or the fixed point one. Typically the fixed point
implementation is larger and slower than the floating point implementation implementation is larger and slower than the floating point implementation
on a system that supports floating point, however it may be faster on a on a system that supports floating point; however, it may be faster on a
system which lacks floating point hardware and therefore uses a software system which lacks floating point hardware and therefore uses a software
emulation. emulation.
@ -5415,7 +5415,7 @@ pngconf.h no longer includes pngusr.h, therefore pngusr.h is ignored after the
build of pnglibconf.h and it is never included in an application build. build of pnglibconf.h and it is never included in an application build.
The rarely used alternative of adding a list of feature macros to the The rarely used alternative of adding a list of feature macros to the
CFLAGS setting in the build also still works, however the macros will be CFLAGS setting in the build also still works; however, the macros will be
copied to pnglibconf.h and this may produce macro redefinition warnings copied to pnglibconf.h and this may produce macro redefinition warnings
when the individual C files are compiled. when the individual C files are compiled.
@ -5584,7 +5584,7 @@ Other rules can be inferred by inspecting the libpng source.
.SH XIV. Y2K Compliance in libpng .SH XIV. Y2K Compliance in libpng
June 7, 2012 June 9, 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.
@ -5861,7 +5861,7 @@ possible without all of you.
Thanks to Frank J. T. Wojcik for helping with the documentation. Thanks to Frank J. T. Wojcik for helping with the documentation.
Libpng version 1.5.11rc06 - June 7, 2012: Libpng version 1.5.11rc06 - June 9, 2012:
Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc. Initially created in 1995 by Guy Eric Schalnat, then of Group 42, Inc.
Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net). Currently maintained by Glenn Randers-Pehrson (glennrp at users.sourceforge.net).
@ -5884,7 +5884,7 @@ this sentence.
This code is released under the libpng license. This code is released under the libpng license.
libpng versions 1.2.6, August 15, 2004, through 1.5.11rc06, June 7, 2012, are libpng versions 1.2.6, August 15, 2004, through 1.5.11rc06, June 9, 2012, are
Copyright (c) 2004,2006-2007 Glenn Randers-Pehrson, and are Copyright (c) 2004,2006-2007 Glenn Randers-Pehrson, and are
distributed according to the same disclaimer and license as libpng-1.2.5 distributed according to the same disclaimer and license as libpng-1.2.5
with the following individual added to the list of Contributing Authors with the following individual added to the list of Contributing Authors
@ -5983,7 +5983,7 @@ certification mark of the Open Source Initiative.
Glenn Randers-Pehrson Glenn Randers-Pehrson
glennrp at users.sourceforge.net glennrp at users.sourceforge.net
June 7, 2012 June 9, 2012
.\" end of man page .\" end of man page

2
scripts/pnglibconf.dfa
View File

@ -21,7 +21,7 @@ file pnglibconf.h scripts/pnglibconf.dfa PNGLCONF_H
# C compiler to generate 'pnglibconf.h' - a list of all the # C compiler to generate 'pnglibconf.h' - a list of all the
# configuration options. The file lists the various options # configuration options. The file lists the various options
# that can *only* be specified during the libpng build; # that can *only* be specified during the libpng build;
# pnglibconf.h freezes the definitons selected for the specific # pnglibconf.h freezes the definitions selected for the specific
# build. # build.
# #
# The syntax is detailed in scripts/options.awk, this is a summary # The syntax is detailed in scripts/options.awk, this is a summary