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

doc: Update the man pages to the final PNG-3 specification

Browse Source 
Also make editorial changes regarding the previous PNG specifications.
This commit is contained in:
Cosmin Truta 2025-07-01 22:57:36 +03:00
parent 9eb25bd899
commit 254a64ec30
4 changed files with 46 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
libpng-manual.txt
View File

@ -65,18 +65,22 @@ Libpng was written as a companion to the PNG specification, as a way
of reducing the amount of time and effort it takes to support the PNG 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 (Third Edition), June 2025, is available as
a W3C Recommendation at
<https://www.w3.org/TR/2025/REC-png-3-20250624/>.
The PNG specification (Second Edition), November 2003, is available as
a W3C Recommendation and as an ISO Standard (ISO/IEC 15948:2004 (E)) at a W3C Recommendation and as an ISO Standard (ISO/IEC 15948:2004 (E)) at
<https://www.w3.org/TR/2003/REC-PNG-20031110/>. <https://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.
The PNG-1.2 specification is available at The PNG-1.2 specification is available at
<https://png-mng.sourceforge.io/pub/png/spec/1.2/>. <https://www.libpng.org/pub/png/spec/1.2/>.
It is technically equivalent It is technically equivalent to the PNG specification (Second Edition)
to the PNG specification (second edition) but has some additional material. but has some additional material.
The PNG-1.0 specification is available as RFC 2083 at The PNG-1.0 specification is available as RFC 2083 at
<https://png-mng.sourceforge.io/pub/png/spec/1.0/> and as a <https://www.libpng.org/pub/png/spec/1.0/> and as a
W3C Recommendation at <https://www.w3.org/TR/REC-png-961001>. W3C Recommendation at <https://www.w3.org/TR/REC-png-961001>.
Some additional chunks are described in the special-purpose public chunks Some additional chunks are described in the special-purpose public chunks

18
libpng.3
View File

@ -1,6 +1,6 @@
.TH LIBPNG 3 "June 12, 2025" .TH LIBPNG 3 "July 1, 2025"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.6.49 libpng \- Portable Network Graphics (PNG) Reference Library 1.6.50.git
.SH SYNOPSIS .SH SYNOPSIS
\fB#include <png.h>\fP \fB#include <png.h>\fP
@ -584,18 +584,22 @@ Libpng was written as a companion to the PNG specification, as a way
of reducing the amount of time and effort it takes to support the PNG 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 (Third Edition), June 2025, is available as
a W3C Recommendation at
<https://www.w3.org/TR/2025/REC-png-3-20250624/>.
The PNG specification (Second Edition), November 2003, is available as
a W3C Recommendation and as an ISO Standard (ISO/IEC 15948:2004 (E)) at a W3C Recommendation and as an ISO Standard (ISO/IEC 15948:2004 (E)) at
<https://www.w3.org/TR/2003/REC-PNG-20031110/>. <https://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.
The PNG-1.2 specification is available at The PNG-1.2 specification is available at
<https://png-mng.sourceforge.io/pub/png/spec/1.2/>. <https://www.libpng.org/pub/png/spec/1.2/>.
It is technically equivalent It is technically equivalent to the PNG specification (Second Edition)
to the PNG specification (second edition) but has some additional material. but has some additional material.
The PNG-1.0 specification is available as RFC 2083 at The PNG-1.0 specification is available as RFC 2083 at
<https://png-mng.sourceforge.io/pub/png/spec/1.0/> and as a <https://www.libpng.org/pub/png/spec/1.0/> and as a
W3C Recommendation at <https://www.w3.org/TR/REC-png-961001>. W3C Recommendation at <https://www.w3.org/TR/REC-png-961001>.
Some additional chunks are described in the special-purpose public chunks Some additional chunks are described in the special-purpose public chunks

4
libpngpf.3
View File

@ -1,6 +1,6 @@
.TH LIBPNGPF 3 "June 12, 2025" .TH LIBPNGPF 3 "July 1, 2025"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.6.49 libpng \- Portable Network Graphics (PNG) Reference Library 1.6.50.git
.SH SYNOPSIS .SH SYNOPSIS
\fB#include "pngpriv.h"\fP \fB#include "pngpriv.h"\fP

34
png.5
View File

@ -1,4 +1,4 @@
.TH PNG 5 "June 12, 2025" .TH PNG 5 "July 1, 2025"
.SH NAME .SH NAME
png \- Portable Network Graphics (PNG) format png \- Portable Network Graphics (PNG) format
@ -20,20 +20,25 @@ matching on heterogeneous platforms.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR "libpng"(3), " zlib"(3), " deflate"(5), " " and " zlib"(5) .BR "libpng"(3), " zlib"(3), " deflate"(5), " " and " zlib"(5)
.LP .LP
PNG Specification (Third Edition) Proposed Recommendation, May 2025: PNG Specification (Third Edition), June 2025:
.IP .IP
.br .br
https://www.w3.org/TR/2025/PR-png-3-20250515/ https://www.w3.org/TR/2025/REC-png-3-20250624/
.LP .LP
PNG Specification (Second Edition), November 2003: PNG Specification (Second Edition), November 2003:
.IP .IP
.br .br
https://www.w3.org/TR/2003/REC-PNG-20031110/ https://www.w3.org/TR/2003/REC-PNG-20031110/
.LP .LP
PNG 1.2 Specification, July 1999: PNG 1.2 Specification, August 1999:
.IP .IP
.br .br
https://png-mng.sourceforge.io/pub/png/spec/1.2/ https://www.libpng.org/pub/png/spec/1.2/
.LP
PNG 1.1 Specification, December 1998:
.IP
.br
https://www.libpng.org/pub/png/spec/1.1/
.LP .LP
PNG 1.0 Specification, October 1996: PNG 1.0 Specification, October 1996:
.IP .IP
@ -50,15 +55,24 @@ https://www.w3.org/TR/REC-png-961001
.SH AUTHORS .SH AUTHORS
This man page: Glenn Randers-Pehrson, Cosmin Truta This man page: Glenn Randers-Pehrson, Cosmin Truta
.LP .LP
Portable Network Graphics (PNG) Specification (Third Edition).
W3C Recommendation 24 June 2025:
Chris Blume et al.
.LP
Portable Network Graphics (PNG) Specification (Second Edition) Portable Network Graphics (PNG) Specification (Second Edition)
Information technology - Computer graphics and image processing - Information technology - Computer graphics and image processing -
Portable Network Graphics (PNG): Functional specification. Portable Network Graphics (PNG): Functional specification.
ISO/IEC 15948:2003 (E) (November 10, 2003): David Duce and others. ISO/IEC 15948:2003 (E), W3C Recommendation 10 November 2003:
David Duce et al.
.LP .LP
Portable Network Graphics (PNG) Specification Version 1.2 (July 8, 1999): Portable Network Graphics (PNG) Specification Version 1.2 (11 August 1999):
Glenn Randers-Pehrson and others. Glenn Randers-Pehrson et al.
.LP .LP
Portable Network Graphics (PNG) Specification Version 1.0 (October 1, 1996): Portable Network Graphics (PNG) Specification Version 1.1 (31 December 1998):
Thomas Boutell and others. Glenn Randers-Pehrson et al.
.LP
Portable Network Graphics (PNG) Specification Version 1.0.
IETF RFC 2083, W3C Recommendation 1 October 1996:
Thomas Boutell et al.
.\" end of man page .\" end of man page