annotate src/zlib-1.2.8/contrib/ada/readme.txt @ 56:af97cad61ff0

Add updated build of PortAudio for OSX
author Chris Cannam <cannam@all-day-breakfast.com>
date Tue, 03 Jan 2017 15:10:52 +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>