~ubuntu-branches/ubuntu/saucy/clamav/saucy

« back to all changes in this revision

Viewing changes to win32/3rdparty/zlib/contrib/pascal/readme.txt

  • Committer: Bazaar Package Importer
  • Author(s): Leonel Nunez
  • Date: 2008-02-11 22:52:13 UTC
  • mfrom: (1.1.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 38.
  • Revision ID: james.westby@ubuntu.com-20080211225213-p2uwj4czso1w2f8h
Tags: upstream-0.92~dfsg
ImportĀ upstreamĀ versionĀ 0.92~dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
 
2
 
This directory contains a Pascal (Delphi, Kylix) interface to the
3
 
zlib data compression library.
4
 
 
5
 
 
6
 
Directory listing
7
 
=================
8
 
 
9
 
zlibd32.mak     makefile for Borland C++
10
 
example.pas     usage example of zlib
11
 
zlibpas.pas     the Pascal interface to zlib
12
 
readme.txt      this file
13
 
 
14
 
 
15
 
Compatibility notes
16
 
===================
17
 
 
18
 
- Although the name "zlib" would have been more normal for the
19
 
  zlibpas unit, this name is already taken by Borland's ZLib unit.
20
 
  This is somehow unfortunate, because that unit is not a genuine
21
 
  interface to the full-fledged zlib functionality, but a suite of
22
 
  class wrappers around zlib streams.  Other essential features,
23
 
  such as checksums, are missing.
24
 
  It would have been more appropriate for that unit to have a name
25
 
  like "ZStreams", or something similar.
26
 
 
27
 
- The C and zlib-supplied types int, uInt, long, uLong, etc. are
28
 
  translated directly into Pascal types of similar sizes (Integer,
29
 
  LongInt, etc.), to avoid namespace pollution.  In particular,
30
 
  there is no conversion of unsigned int into a Pascal unsigned
31
 
  integer.  The Word type is non-portable and has the same size
32
 
  (16 bits) both in a 16-bit and in a 32-bit environment, unlike
33
 
  Integer.  Even if there is a 32-bit Cardinal type, there is no
34
 
  real need for unsigned int in zlib under a 32-bit environment.
35
 
 
36
 
- Except for the callbacks, the zlib function interfaces are
37
 
  assuming the calling convention normally used in Pascal
38
 
  (__pascal for DOS and Windows16, __fastcall for Windows32).
39
 
  Since the cdecl keyword is used, the old Turbo Pascal does
40
 
  not work with this interface.
41
 
 
42
 
- The gz* function interfaces are not translated, to avoid
43
 
  interfacing problems with the C runtime library.  Besides,
44
 
    gzprintf(gzFile file, const char *format, ...)
45
 
  cannot be translated into Pascal.
46
 
 
47
 
 
48
 
Legal issues
49
 
============
50
 
 
51
 
The zlibpas interface is:
52
 
  Copyright (C) 1995-2003 Jean-loup Gailly and Mark Adler.
53
 
  Copyright (C) 1998 by Bob Dellaca.
54
 
  Copyright (C) 2003 by Cosmin Truta.
55
 
 
56
 
The example program is:
57
 
  Copyright (C) 1995-2003 by Jean-loup Gailly.
58
 
  Copyright (C) 1998,1999,2000 by Jacques Nomssi Nzali.
59
 
  Copyright (C) 2003 by Cosmin Truta.
60
 
 
61
 
  This software is provided 'as-is', without any express or implied
62
 
  warranty.  In no event will the author be held liable for any damages
63
 
  arising from the use of this software.
64
 
 
65
 
  Permission is granted to anyone to use this software for any purpose,
66
 
  including commercial applications, and to alter it and redistribute it
67
 
  freely, subject to the following restrictions:
68
 
 
69
 
  1. The origin of this software must not be misrepresented; you must not
70
 
     claim that you wrote the original software. If you use this software
71
 
     in a product, an acknowledgment in the product documentation would be
72
 
     appreciated but is not required.
73
 
  2. Altered source versions must be plainly marked as such, and must not be
74
 
     misrepresented as being the original software.
75
 
  3. This notice may not be removed or altered from any source distribution.
76