Changeset c12cbbf in rtems


Ignore:
Timestamp:
Mar 18, 2011, 10:11:18 AM (9 years ago)
Author:
Ralf Corsepius <ralf.corsepius@…>
Branches:
4.11, master
Children:
df7764c
Parents:
28f0f60a
Message:

Import from zlib-1.2.4

File:
1 edited

Legend:

Unmodified
Added
Removed
  • cpukit/zlib/README

    r28f0f60a rc12cbbf  
    11ZLIB DATA COMPRESSION LIBRARY
    22
    3 zlib 1.2.3 is a general purpose data compression library.  All the code is
     3zlib 1.2.4 is a general purpose data compression library.  All the code is
    44thread safe.  The data format used by the zlib library is described by RFCs
    55(Request for Comments) 1950 to 1952 in the files
    66http://www.ietf.org/rfc/rfc1950.txt (zlib format), rfc1951.txt (deflate format)
    7 and rfc1952.txt (gzip format). These documents are also available in other
    8 formats from ftp://ftp.uu.net/graphics/png/documents/zlib/zdoc-index.html
     7and rfc1952.txt (gzip format).
    98
    109All functions of the compression library are documented in the file zlib.h
    11 (volunteer to write man pages welcome, contact zlib@gzip.org). A usage example
     10(volunteer to write man pages welcome, contact zlib@gzip.org).  A usage example
    1211of the library is given in the file example.c which also tests that the library
    13 is working correctly. Another example is given in the file minigzip.c. The
     12is working correctly.  Another example is given in the file minigzip.c. The
    1413compression library itself is composed of all source files except example.c and
    1514minigzip.c.
    1615
    1716To compile all files and run the test program, follow the instructions given at
    18 the top of Makefile. In short "make test; make install" should work for most
    19 machines. For Unix: "./configure; make test; make install". For MSDOS, use one
    20 of the special makefiles such as Makefile.msc. For VMS, use make_vms.com.
     17the top of Makefile.in.  In short "./configure; make test", and if that goes
     18well, "make install" should work for most flavors of Unix.  For Windows, use one
     19of the special makefiles in win32/ or projects/ . For VMS, use make_vms.com.
    2120
    2221Questions about zlib should be sent to <zlib@gzip.org>, or to Gilles Vollant
    23 <info@winimage.com> for the Windows DLL version. The zlib home page is
    24 http://www.zlib.org or http://www.gzip.org/zlib/ Before reporting a problem,
    25 please check this site to verify that you have the latest version of zlib;
    26 otherwise get the latest version and check whether the problem still exists or
    27 not.
     22<info@winimage.com> for the Windows DLL version.  The zlib home page is
     23http://zlib.net/ .  Before reporting a problem, please check this site to
     24verify that you have the latest version of zlib; otherwise get the latest
     25version and check whether the problem still exists or not.
    2826
    29 PLEASE read the zlib FAQ http://www.gzip.org/zlib/zlib_faq.html before asking
    30 for help.
     27PLEASE read the zlib FAQ http://zlib.net/zlib_faq.html before asking for help.
    3128
    32 Mark Nelson <markn@ieee.org> wrote an article about zlib for the Jan. 1997
    33 issue of  Dr. Dobb's Journal; a copy of the article is available in
    34 http://dogma.net/markn/articles/zlibtool/zlibtool.htm
     29Mark Nelson <markn@ieee.org> wrote an article about zlib for the Jan.  1997
     30issue of Dr.  Dobb's Journal; a copy of the article is available at
     31http://marknelson.us/1997/01/01/zlib-engine/ .
    3532
    36 The changes made in version 1.2.3 are documented in the file ChangeLog.
     33The changes made in version 1.2.4 are documented in the file ChangeLog.
    3734
    38 Unsupported third party contributions are provided in directory "contrib".
     35Unsupported third party contributions are provided in directory contrib/ .
    3936
    40 A Java implementation of zlib is available in the Java Development Kit
    41 http://java.sun.com/j2se/1.4.2/docs/api/java/util/zip/package-summary.html
    42 See the zlib home page http://www.zlib.org for details.
     37zlib is available in Java using the java.util.zip package, documented at
     38http://java.sun.com/developer/technicalArticles/Programming/compression/ .
    4339
    44 A Perl interface to zlib written by Paul Marquess <pmqs@cpan.org> is in the
    45 CPAN (Comprehensive Perl Archive Network) sites
    46 http://www.cpan.org/modules/by-module/Compress/
     40A Perl interface to zlib written by Paul Marquess <pmqs@cpan.org> is available
     41at CPAN (Comprehensive Perl Archive Network) sites, including
     42http://search.cpan.org/~pmqs/IO-Compress-Zlib/ .
    4743
    4844A Python interface to zlib written by A.M. Kuchling <amk@amk.ca> is
    4945available in Python 1.5 and later versions, see
    50 http://www.python.org/doc/lib/module-zlib.html
     46http://www.python.org/doc/lib/module-zlib.html .
    5147
    52 A zlib binding for TCL written by Andreas Kupries <a.kupries@westend.com> is
    53 availlable at http://www.oche.de/~akupries/soft/trf/trf_zip.html
     48zlib is built into tcl: http://wiki.tcl.tk/4610 .
    5449
    5550An experimental package to read and write files in .zip format, written on top
     
    7570  other compilers. Use "make test" to check your compiler.
    7671
    77 - gzdopen is not supported on RISCOS, BEOS and by some Mac compilers.
     72- gzdopen is not supported on RISCOS or BEOS.
    7873
    7974- For PalmOs, see http://palmzlib.sourceforge.net/
    80 
    81 - When building a shared, i.e. dynamic library on Mac OS X, the library must be
    82   installed before testing (do "make install" before "make test"), since the
    83   library location is specified in the library.
    8475
    8576
    8677Acknowledgments:
    8778
    88   The deflate format used by zlib was defined by Phil Katz. The deflate
    89   and zlib specifications were written by L. Peter Deutsch. Thanks to all the
    90   people who reported problems and suggested various improvements in zlib;
    91   they are too numerous to cite here.
     79  The deflate format used by zlib was defined by Phil Katz.  The deflate and
     80  zlib specifications were written by L.  Peter Deutsch. Thanks to all the
     81  people who reported problems and suggested various improvements in zlib; they
     82  are too numerous to cite here.
    9283
    9384Copyright notice:
    9485
    95  (C) 1995-2004 Jean-loup Gailly and Mark Adler
     86 (C) 1995-2010 Jean-loup Gailly and Mark Adler
    9687
    9788  This software is provided 'as-is', without any express or implied
     
    114105  jloup@gzip.org          madler@alumni.caltech.edu
    115106
    116 If you use the zlib library in a product, we would appreciate *not*
    117 receiving lengthy legal documents to sign. The sources are provided
    118 for free but without warranty of any kind.  The library has been
    119 entirely written by Jean-loup Gailly and Mark Adler; it does not
    120 include third-party code.
     107If you use the zlib library in a product, we would appreciate *not* receiving
     108lengthy legal documents to sign.  The sources are provided for free but without
     109warranty of any kind.  The library has been entirely written by Jean-loup
     110Gailly and Mark Adler; it does not include third-party code.
    121111
    122 If you redistribute modified sources, we would appreciate that you include
    123 in the file ChangeLog history information documenting your changes. Please
    124 read the FAQ for more information on the distribution of modified source
    125 versions.
     112If you redistribute modified sources, we would appreciate that you include in
     113the file ChangeLog history information documenting your changes.  Please read
     114the FAQ for more information on the distribution of modified source versions.
Note: See TracChangeset for help on using the changeset viewer.