/packages/paszlib/readme.txt

  1_____________________________________________________________________________
  2
  3PASZLIB 1.0                                                   May 11th, 1998
  4
  5Based on the zlib 1.1.2, a general purpose data compression library.
  6
  7Copyright (C) 1998,1999,2000 by NOMSSI NZALI Jacques H. C. 
  8[kn&n DES]         See "Legal issues" for conditions of distribution and use.
  9_____________________________________________________________________________
 10
 11
 12Introduction
 13============
 14
 15The 'zlib' compression library provides in-memory compression and
 16decompression functions, including integrity checks of the uncompressed
 17data.  This version of the library supports only one compression method
 18(deflation) but other algorithms will be added later and will have the same
 19stream interface.
 20
 21Compression can be done in a single step if the buffers are large
 22enough (for example if an input file is mmap'ed), or can be done by
 23repeated calls of the compression function.  In the latter case, the
 24application must provide more input and/or consume the output
 25(providing more output space) before each call.
 26
 27The default memory requirements for deflate are 256K plus a few kilobytes
 28for small objects. The default memory requirements for inflate are 32K
 29plus a few kilobytes for small objects.
 30
 31Change Log
 32==========
 33
 34March 24th 2000 - minizip code by Gilles Vollant ported to Pascal. 
 35                  z_stream.msg defined as string[255] to avoid problems
 36                  with Delphi 2+ dynamic string handling.
 37                  changes to silence Delphi 5 compiler warning. If you
 38                  have Delphi 5, defines Delphi5 in zconf.inc
 39                              
 40May 7th 1999    - Some changes for FPC
 41                  deflateCopy() has new parameters
 42                  trees.pas - record constant definition
 43June 17th 1998  - Applied official 1.1.2 patch. 
 44	          Memcheck turned off by default.
 45                  zutil.pas patch for Delphi 1 memory allocation corrected.
 46                  dzlib.txt file added.
 47                  compress2() is now exported
 48
 49June 25th 1998 -  fixed a conversion bug: in inftrees.pas, ZFREE(z, v) was
 50                  missing in line 574;
 51
 52File list
 53=========
 54
 55Here is a road map to the files in the Paszlib distribution.
 56
 57readme.txt      Introduction, Documentation
 58dzlib.txt       Changes to Delphi sources for Paszlib stream classes 
 59
 60include file
 61
 62zconf.inc       Configuration declarations.
 63
 64Pascal source code files:
 65
 66adler.pas      compute the Adler-32 checksum of a data stream
 67crc.pas        compute the CRC-32 of a data stream
 68gzio.pas       IO on .gz files
 69infblock.pas   interpret and process block types to last block
 70infcodes.pas   process literals and length/distance pairs
 71inffast.pas    process literals and length/distance pairs fast
 72inftrees.pas   generate Huffman trees for efficient decoding
 73infutil.pas    types and macros common to blocks and codes
 74strutils.pas   string utilities
 75trees.pas      output deflated data using Huffman coding
 76zcompres.pas   compress a memory buffer
 77zdeflate.pas   compress data using the deflation algorithm
 78zinflate.pas   zlib interface to inflate modules
 79zlib.pas       zlib data structures. read the comments there!
 80zuncompr.pas   decompress a memory buffer
 81zutil.pas
 82
 83minizip/ziputils.pas data structure and IO on .zip file 
 84minizip/unzip.pas  
 85minizip/zip.pas
 86      
 87Test applications
 88
 89example.pas    usage example of the zlib compression library
 90minigzip.pas   simulate gzip using the zlib compression library
 91minizip/miniunz.pas  simulates unzip using the zlib compression library
 92minizip/minizip.pas  simulates zip using the zlib compression library
 93
 94Legal issues
 95============
 96
 97Copyright (C) 1998,1999,2000 by Jacques Nomssi Nzali
 98
 99  This software is provided 'as-is', without any express or implied
100  warranty.  In no event will the author be held liable for any damages
101  arising from the use of this software.
102
103  Permission is granted to anyone to use this software for any purpose,
104  including commercial applications, and to alter it and redistribute it
105  freely, subject to the following restrictions:
106
107  1. The origin of this software must not be misrepresented; you must not
108     claim that you wrote the original software. If you use this software
109     in a product, an acknowledgment in the product documentation would be
110     appreciated but is not required.
111  2. Altered source versions must be plainly marked as such, and must not be
112     misrepresented as being the original software.
113  3. This notice may not be removed or altered from any source distribution.
114
115
116Archive Locations:
117==================
118
119Check the Paszlib home page with links
120
121      http://www.tu-chemnitz.de/~nomssi/paszlib.html
122
123The data format used by the zlib library is described by RFCs (Request for
124Comments) 1950 to 1952 in the files ftp://ds.internic.net/rfc/rfc1950.txt
125(zlib format), rfc1951.txt (deflate format) and rfc1952.txt (gzip format).
126These documents are also available in other formats from
127ftp://ftp.uu.net/graphics/png/documents/zlib/zdoc-index.html.
128____________________________________________________________________________
129Jacques Nomssi Nzali <mailto:nomssi@physik.tu-chemnitz.de> March 24th, 2000