doc: Update the png.5 man page to the latest PNG-3 draft specification

Also update libpngpf.3 to explicitly state that the internal functions
should not be used by applications.
This commit is contained in:
Cosmin Truta 2025-04-30 16:30:24 +03:00
parent 34e3f7a65b
commit 643dbda7d6
3 changed files with 12 additions and 19 deletions

View File

@ -1,6 +1,6 @@
.TH LIBPNG 3 "February 18, 2025" .TH LIBPNG 3 "April 30, 2025"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.6.47 libpng \- Portable Network Graphics (PNG) Reference Library 1.6.48.git
.SH SYNOPSIS .SH SYNOPSIS
\fB#include <png.h>\fP \fB#include <png.h>\fP

View File

@ -1,24 +1,17 @@
.TH LIBPNGPF 3 "February 18, 2025" .TH LIBPNGPF 3 "April 30, 2025"
.SH NAME .SH NAME
libpng \- Portable Network Graphics (PNG) Reference Library 1.6.47 libpng \- Portable Network Graphics (PNG) Reference Library 1.6.48.git
(private functions)
.SH SYNOPSIS .SH SYNOPSIS
\fB#include \fI"pngpriv.h" \fB#include "pngpriv.h"\fP
\fBAs of libpng version \fP\fI1.5.1\fP\fB, this section is no longer
\fP\fImaintained\fP\fB, now that the private function prototypes are hidden in
\fP\fIpngpriv.h\fP\fB and not accessible to applications. Look in
\fP\fIpngpriv.h\fP\fB for the prototypes and a short description of each
function.
.SH DESCRIPTION .SH DESCRIPTION
The functions previously listed here are used privately by libpng and are not As of libpng version 1.5.1, this manual is no longer maintained. The private
available for use by applications. They are not "exported" to applications function prototypes, declared in private header files, should not be accessed
using shared libraries. by applications.
.SH "SEE ALSO" .SH "SEE ALSO"
.BR "png"(5), " libpng"(3), " zlib"(3), " deflate"(5), " " and " zlib"(5) .BR "libpng"(3)
.SH AUTHORS .SH AUTHORS
Cosmin Truta, Glenn Randers-Pehrson Cosmin Truta, Glenn Randers-Pehrson

6
png.5
View File

@ -1,4 +1,4 @@
.TH PNG 5 "February 18, 2025" .TH PNG 5 "April 30, 2025"
.SH NAME .SH NAME
png \- Portable Network Graphics (PNG) format png \- Portable Network Graphics (PNG) format
@ -20,10 +20,10 @@ 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) Candidate Recommendation Draft, January 2025: PNG Specification (Third Edition) Candidate Recommendation, March 2025:
.IP .IP
.br .br
https://www.w3.org/TR/2025/CRD-png-3-20250121/ https://www.w3.org/TR/2025/CR-png-3-20250313/
.LP .LP
PNG Specification (Second Edition), November 2003: PNG Specification (Second Edition), November 2003:
.IP .IP