annotate src/zlib-1.2.8/contrib/ada/readme.txt @ 83:ae30d91d2ffe

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