gcc/

[pf3gnuchains/gcc-fork.git] / zlib / zlib.3

diff --git a/zlib/zlib.3 b/zlib/zlib.3
index 3a6e450..90b8162 100644 (file)
--- a/zlib/zlib.3
+++ b/zlib/zlib.3
@@ -1,4 +1,4 @@
-.TH ZLIB 3 "11 March 2002"
+.TH ZLIB 3 "18 July 2005"

 .SH NAME
 zlib \- compression/decompression library
 .SH SYNOPSIS
 .SH NAME
 zlib \- compression/decompression library
 .SH SYNOPSIS


@@ -13,7 +13,8 @@ The code is thread safe.
 It provides in-memory compression and decompression functions,
 including integrity checks of the uncompressed data.
 This version of the library supports only one compression method (deflation)
 It provides in-memory compression and decompression functions,
 including integrity checks of the uncompressed data.
 This version of the library supports only one compression method (deflation)

-but other algorithms will be added later and will have the same stream interface.
+but other algorithms will be added later
+and will have the same stream interface.

 .LP
 Compression can be done in a single step if the buffers are large enough
 (for example if an input file is mmap'ed),
 .LP
 Compression can be done in a single step if the buffers are large enough
 (for example if an input file is mmap'ed),


@@ -23,66 +24,117 @@ the application must provide more input and/or consume the output
 (providing more output space) before each call.
 .LP
 The library also supports reading and writing files in
 (providing more output space) before each call.
 .LP
 The library also supports reading and writing files in

-.I gzip
+.IR gzip (1)

 (.gz) format
 with an interface similar to that of stdio.
 .LP
 (.gz) format
 with an interface similar to that of stdio.
 .LP

-The library does not install any signal handler. The decoder checks
-the consistency of the compressed data, so the library should never
-crash even in case of corrupted input.
+The library does not install any signal handler.
+The decoder checks the consistency of the compressed data,
+so the library should never crash even in case of corrupted input.

 .LP
 All functions of the compression library are documented in the file
 .LP
 All functions of the compression library are documented in the file

-.IR zlib.h.
+.IR zlib.h .

 The distribution source includes examples of use of the library
 The distribution source includes examples of use of the library

-the files
+in the files

 .I example.c
 and
 .IR minigzip.c .
 .LP
 .I example.c
 and
 .IR minigzip.c .
 .LP

+Changes to this version are documented in the file
+.I ChangeLog
+that accompanies the source,
+and are concerned primarily with bug fixes and portability enhancements.
+.LP

 A Java implementation of
 A Java implementation of

-.IR zlib
-is available in the Java Development Kit 1.1
+.I zlib
+is available in the Java Development Kit 1.1:

 .IP
 http://www.javasoft.com/products/JDK/1.1/docs/api/Package-java.util.zip.html
 .LP
 A Perl interface to
 .IR zlib ,
 .IP
 http://www.javasoft.com/products/JDK/1.1/docs/api/Package-java.util.zip.html
 .LP
 A Perl interface to
 .IR zlib ,

-written by Paul Marquess (pmarquess@bfsec.bt.co.uk)
+written by Paul Marquess (pmqs@cpan.org),

 is available at CPAN (Comprehensive Perl Archive Network) sites,
 is available at CPAN (Comprehensive Perl Archive Network) sites,

-such as:
+including:

 .IP
 .IP

-ftp://ftp.cis.ufl.edu/pub/perl/CPAN/modules/by-module/Compress/Compress-Zlib*
+http://www.cpan.org/modules/by-module/Compress/

 .LP
 A Python interface to
 .LP
 A Python interface to

-.IR zlib
-written by A.M. Kuchling <amk@magnet.com>
-is available from the Python Software Association sites, such as:
+.IR zlib ,
+written by A.M. Kuchling (amk@magnet.com),
+is available in Python 1.5 and later versions:

 .IP
 .IP

-ftp://ftp.python.org/pub/python/contrib/Encoding/zlib*.tar.gz
-.SH "SEE ALSO"
-Questions about zlib should be sent to:
+http://www.python.org/doc/lib/module-zlib.html
+.LP
+A
+.I zlib
+binding for
+.IR tcl (1),
+written by Andreas Kupries (a.kupries@westend.com),
+is availlable at:

 .IP
 .IP

-zlib@quest.jpl.nasa.gov
-or, if this fails, to the author addresses given below.
-The zlib home page is:
+http://www.westend.com/~kupries/doc/trf/man/man.html
+.LP
+An experimental package to read and write files in .zip format,
+written on top of
+.I zlib
+by Gilles Vollant (info@winimage.com),
+is available at:
+.IP
+http://www.winimage.com/zLibDll/unzip.html
+and also in the
+.I contrib/minizip
+directory of the main
+.I zlib
+web site.
+.SH "SEE ALSO"
+The
+.I zlib
+web site can be found at either of these locations:

 .IP
 .IP

-http://www.cdrom.com/pub/infozip/zlib/
+http://www.zlib.org
+.br
+http://www.gzip.org/zlib/

 .LP
 The data format used by the zlib library is described by RFC
 .LP
 The data format used by the zlib library is described by RFC

-(Request for Comments) 1950 to 1952 in the files: 
+(Request for Comments) 1950 to 1952 in the files:

 .IP
 .IP

-ftp://ds.internic.net/rfc/rfc1950.txt (zlib format)
+http://www.ietf.org/rfc/rfc1950.txt (concerning zlib format)

 .br
 .br

-rfc1951.txt (deflate format)
+http://www.ietf.org/rfc/rfc1951.txt (concerning deflate format)

 .br
 .br

-rfc1952.txt (gzip format)
+http://www.ietf.org/rfc/rfc1952.txt (concerning gzip format)

 .LP
 These documents are also available in other formats from:
 .IP
 ftp://ftp.uu.net/graphics/png/documents/zlib/zdoc-index.html
 .LP
 These documents are also available in other formats from:
 .IP
 ftp://ftp.uu.net/graphics/png/documents/zlib/zdoc-index.html

+.LP
+Mark Nelson (markn@ieee.org) wrote an article about
+.I zlib
+for the Jan. 1997 issue of  Dr. Dobb's Journal;
+a copy of the article is available at:
+.IP
+http://dogma.net/markn/articles/zlibtool/zlibtool.htm
+.SH "REPORTING PROBLEMS"
+Before reporting a problem,
+please check the
+.I zlib
+web site to verify that you have the latest version of
+.IR zlib ;
+otherwise,
+obtain the latest version and see if the problem still exists.
+Please read the
+.I zlib
+FAQ at:
+.IP
+http://www.gzip.org/zlib/zlib_faq.html
+.LP
+before asking for help.
+Send questions and/or comments to zlib@gzip.org,
+or (for the Windows DLL version) to Gilles Vollant (info@winimage.com).

 .SH AUTHORS
 .SH AUTHORS

-Version 1.1.4
-Copyright (C) 1995-2002 Jean-loup Gailly (jloup@gzip.org)
+Version 1.2.3
+Copyright (C) 1995-2005 Jean-loup Gailly (jloup@gzip.org)

 and Mark Adler (madler@alumni.caltech.edu).
 .LP
 This software is provided "as-is,"
 and Mark Adler (madler@alumni.caltech.edu).
 .LP
 This software is provided "as-is,"