            GNat Ada Database Environment (GNADE)
            ====================================
                  Revision : $Revision: 1.4 $



Contents
========
1. Introduction
2. License/Authors
3. Other supported Platforms
4. Software requirements
5. Integration with GPS
6. Compiling the release
7. Documentation
8. Contact

1. Introduction
===============

This is the Windows Release of GNADE. The GNADE projects 
provides tools and support packages in order to allow easy 
access to different data base systems using Ada 95 
(specially the GNU Ada 95 compiler GNAT).

The integration of SQL into Ada 95 is supported by an
embedded SQL translator which generates code working on
top of the GNADE ODBC bindings.

The GNADE ODBC bindings are a thin Ada 95 binding to 
ODBC.

The projects provides additionaly native bindings
to PostgreSQL, MySQL, Oracle and SQLite.

GNADE is delivered as an installer program which provides the 
following installation components:

(1) Software Development Kit
(2) ODBC Tools
(3) Samples & Sample Database
(4) Source code
(5) Source code addons

The SDK contains everything to develop OBC and embedded SQL
based application. The SDK contents located in the subdirectories:

   win32-bin     : Binaries
   win32-lib     : Static libs of gnade
   win32-include : Package specifications

The ODBC tools, located in win32-bin, are a set of small tools based 
on ODBC to import/export database contents. 

The samples and sample database is a single standalone example
how to use ODBC and embedded SQL. This component includes also
the scripts to create a test database.

The source code package contains the source code for this 
release. 


2. License/Authors
==================

Generally speaking GNADE is an open source project.  For details 
please refer to the ./COPYING and ./AUTHORS files in this 
directory.

3. Other supported Platforms
============================
 
Beside of Windows, this software is known to work on:
 
- Linux SuSe, Redhat and Debian distribution
- Solaris

for more information please refere to the release note of 
this release.
                
4. Software Requirements        
========================

GNADE is expected to be used in combination with GNAT 3.15p.
Note that the Windows distribution of GNAT is in two parts; the
standard GNAT tools in gnat-3.15p-nt.exe and the extra Windows tools
and libraries in gnatwin-3.15p.exe. Both must be installed.

If GNADE is to be used as a development environment for applications
no additional tools are required.

If GNADE is to be rebuild and packaged for windows, the following tools 
are required:

- GNAT 3.15p (ftp://cs.nyu.edu)
- Inno Setup 4 (http://www.innosetup.com)

If you like to use the test database you need to install Mimer SQL 9.2
from http://www.mimer.com/.


5. Integration with GPS
=======================

If you are developing Ada 95 data base applications with GNAT you
may wish to use the GPS from http://www.act-europe.com which 
provides a resonable IDE for Ada 95 and the GNAT complier.

In order to do so, include always the project /GNADE which 
provides the environment variables for the project file. For more 
details please refere to the example located in /GNAT/standalone.
Since developing with embedded SQL requieres a preprocessor
run of the gesql tool, the normal build targets cannot be used.
Instead use always the custom build (shortcut F9).


6. Compiling the release
========================

After running the installer for windows, the source code will be 
installed under:
 
    c:\gnat\sources
    
The source code may be recompiled at this place by performing the 
to steps:

    $ configure
    $ make

The compilation result will be stored in the same directory in the 
subdirectories:

    win32-bin
    win32-lib
    win32-include
    

7. Documentation
================

Currently the documentation is only available for Linux. 


8. Contact
==========

If you find an error or you need support, please 
use the facilities at:

   http://sourceforge.net/projects/gnade 


PLEASE FEEL FREE TO CONTRIBUTE TO THE PROJECT BY TESTING
AGAINST LEGACY CODE. PLEASE PROVIDE ME THE RESULTS OF YOUR
TESTS THAT I AM ABLE TO ADOPT THE ESQL TRANSLATOR TO YOUR 
REQUIREMENTS.

All official distributions will be stored  here as well.

In case you port the software to a different platform, 
please keep me informed either by sending me a mail

    Michael.Erdmann@snafu.de

or use the bug reporting facilities at:

    http://sourceforge.net/projects/gnade

A mailing list for GNADE related discussion has been 
established. In order do subscribe to the list goto:

    http://sourceforge.net/projects/gnade

