annotate src/zlib-1.2.7/contrib/ada/readme.txt @ 148:b4bfdf10c4b3

Update Win64 capnp builds to v0.6
author Chris Cannam <cannam@all-day-breakfast.com>
date Mon, 22 May 2017 18:56:49 +0100
parents 8a15ff55d9af
children
rev   line source
cannam@89 1 ZLib for Ada thick binding (ZLib.Ada)
cannam@89 2 Release 1.3
cannam@89 3
cannam@89 4 ZLib.Ada is a thick binding interface to the popular ZLib data
cannam@89 5 compression library, available at http://www.gzip.org/zlib/.
cannam@89 6 It provides Ada-style access to the ZLib C library.
cannam@89 7
cannam@89 8
cannam@89 9 Here are the main changes since ZLib.Ada 1.2:
cannam@89 10
cannam@89 11 - Attension: ZLib.Read generic routine have a initialization requirement
cannam@89 12 for Read_Last parameter now. It is a bit incompartible with previous version,
cannam@89 13 but extends functionality, we could use new parameters Allow_Read_Some and
cannam@89 14 Flush now.
cannam@89 15
cannam@89 16 - Added Is_Open routines to ZLib and ZLib.Streams packages.
cannam@89 17
cannam@89 18 - Add pragma Assert to check Stream_Element is 8 bit.
cannam@89 19
cannam@89 20 - Fix extraction to buffer with exact known decompressed size. Error reported by
cannam@89 21 Steve Sangwine.
cannam@89 22
cannam@89 23 - Fix definition of ULong (changed to unsigned_long), fix regression on 64 bits
cannam@89 24 computers. Patch provided by Pascal Obry.
cannam@89 25
cannam@89 26 - Add Status_Error exception definition.
cannam@89 27
cannam@89 28 - Add pragma Assertion that Ada.Streams.Stream_Element size is 8 bit.
cannam@89 29
cannam@89 30
cannam@89 31 How to build ZLib.Ada under GNAT
cannam@89 32
cannam@89 33 You should have the ZLib library already build on your computer, before
cannam@89 34 building ZLib.Ada. Make the directory of ZLib.Ada sources current and
cannam@89 35 issue the command:
cannam@89 36
cannam@89 37 gnatmake test -largs -L<directory where libz.a is> -lz
cannam@89 38
cannam@89 39 Or use the GNAT project file build for GNAT 3.15 or later:
cannam@89 40
cannam@89 41 gnatmake -Pzlib.gpr -L<directory where libz.a is>
cannam@89 42
cannam@89 43
cannam@89 44 How to build ZLib.Ada under Aonix ObjectAda for Win32 7.2.2
cannam@89 45
cannam@89 46 1. Make a project with all *.ads and *.adb files from the distribution.
cannam@89 47 2. Build the libz.a library from the ZLib C sources.
cannam@89 48 3. Rename libz.a to z.lib.
cannam@89 49 4. Add the library z.lib to the project.
cannam@89 50 5. Add the libc.lib library from the ObjectAda distribution to the project.
cannam@89 51 6. Build the executable using test.adb as a main procedure.
cannam@89 52
cannam@89 53
cannam@89 54 How to use ZLib.Ada
cannam@89 55
cannam@89 56 The source files test.adb and read.adb are small demo programs that show
cannam@89 57 the main functionality of ZLib.Ada.
cannam@89 58
cannam@89 59 The routines from the package specifications are commented.
cannam@89 60
cannam@89 61
cannam@89 62 Homepage: http://zlib-ada.sourceforge.net/
cannam@89 63 Author: Dmitriy Anisimkov <anisimkov@yahoo.com>
cannam@89 64
cannam@89 65 Contributors: Pascal Obry <pascal@obry.org>, Steve Sangwine <sjs@essex.ac.uk>