#   Copyright
#
#      Copyright (C) 2009 Jari Aalto
#
#   License
#
#       This program is free software; you can redistribute it and/or modify
#       it under the terms of the GNU General Public License as published by
#       the Free Software Foundation; either version 2 of the License, or
#       (at your option) any later version.
#
#       This program is distributed in the hope that it will be useful,
#       but WITHOUT ANY WARRANTY; without even the implied warranty of
#       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
#       GNU General Public License for more details.
#
#       You should have received a copy of the GNU General Public License
#       along with this program. If not, see <http://www.gnu.org/licenses/>.
#
#   Description
#
#	To learn what TOP LEVEL section to use in manual pages,
#	see POSIX/Susv standard and "tility Description Defaults" at
#	http://www.opengroup.org/onlinepubs/009695399/utilities/xcu_chap01.html#tag_01_11
#
#	This is manual page in Perl POD format. Read more at
#	http://perldoc.perl.org/perlpod.html or run command:
#
#	    perldoc perlpod | less
#
#	To check the syntax:
#
#	    podchecker *.pod
#
#	Create manual page with command:
#
#	    pod2man PAGE.N.pod > PAGE.N

=pod

=head1 NAME

pngcheck - Test PNG image files for corruption, display size, type, compression info

=head1 SYNOPSIS

  pngcheck [-vqt7f] file.png [file.png [...]]
  pngcheck [-vqt7f] file.mng [file.mng [...]]
  pngcheck -{sx}[vqt7f] file-containing-PNGs...

  ... | pngcheck [-sx][vqt7f]

=head1 OPTIONS

=over 4

=item B<-v>

test verbosely (print most chunk data).

=item B<-q>

test quietly (only output errors).

=item B<-t>

print contents of tEXt chunks (can be used with B<-q>).

=item B<-7>

print contents of tEXt chunks, escape chars >=128 (for 7-bit
terminals).

=item B<-p>

Print contents of PLTE, tRNS, hIST, sPLT and PPLT (can be used with
B<-q>).

=item B<-f>

Force continuation even after major errors.

=item B<-s>

Search for PNGs within another file.

=item B<-x>

Search for PNGs and extract them when found.

=back

=head1 DESCRIPTION

pngcheck is the official PNG tester and debugger. Originally designed
simply to test the CRCs within a PNG image file (e.g., to check for
ASCII rather than binary transfer), it has been extended to check and
optionally print almost all the information about a PNG image and to
verify that it conforms to the PNG specification. It also includes
partial support for MNG animations.

It can dump the chunk-level information in the image in human-readable
form. For example, it can be used to print the basic stats about an
image (dimen sions, bit depth, etc.); to list the color and
transparency info in its palette; or to extract the embedded text
annotations. All PNG and JNG chunks are supported, plus almost all MNG
chunks (everything but PAST, DISC, tERm, DROP, DBYK, and ORDR). This
is a command-line program with batch capabilities (e.g., pngcheck
*.png).

=head1 ENVIRONMENT

None.

=head1 FILES

None.

=head1 SEE ALSO

pngchunkdesc(1)
pngchunks(1)
pngcomp(1)
pngcp(1)
pngcrush(1)
pnginfo(1)
pngmeta(1)
pngnq(1)
pngquant(1)

=head1 AUTHORS

Program was written by <foo@example.com>.

This manual page was written by Kevin M. Rosenberg <kmr@debian.org> for
the Debian GNU system (but may be used by others). Updated by Jari
Aalto <jari.aalto@cante.net>. Released under license GNU GPL v2 or (at
your option) any later version. For more information about license, visit
<http://www.gnu.org/copyleft/gpl.html>.

=cut
