DBD::SQLAnywhere -- a SQLAnywhere interface for Perl 5.

   Portions Copyright (c) 1994,1995,1996            Tim Bunce
   Portions Copyright (c) 1996-2010		    iAnywhere Solutions, Inc.

   For license information, please see license.txt included in this
   distribution.

*BEFORE* BUILDING, TESTING AND INSTALLING this you will need to:

    Build, test and install Perl 5 (at least 5.6.0 is recommended).
    It is very important to test it and install it!

    Build, test and install the DBI module (at least DBI 1.51 is
    required) if it is not already included in your perl distribution.

    No SQL Anywhere software needs to be installed to build this
    module; however, a SQL Anywhere client installation is required in
    order to use the module.

    A full SQLAnywhere client+server installation is recommended for
    testing this module otherwise the tests will be skipped.

Building:
    On UNIX:
	[ Linux, Solaris, AIX, HP-UX, etc. ]

	source sa_config.sh (or sa_config.csh) from the SQL Anywhere
	installation

	perl Makefile.PL
	make
	copy demo.db from the SQL Anywhere installation directory
	    to the current directory
	make test
	make install
    
    On Win32:
	[ requires Microsoft C and ActiveState's ActivePerl
	  (www.activestate.com) ]

	NOTE: ActivePerl 5.6.0 build 616 or later is required.

	perl Makefile.PL
	nmake
	copy demo.db from the SQL Anywhere installation directory
	    to the current directory
	nmake test
	nmake install

    Do not hand-edit the generated Makefile as those changes will be
    lost the next time 'perl Makefile.PL' is invoked. Always try to
    make changes via the Makefile.PL command line and/or editing
    Makefile.PL.

---------------------------------------------------------------

Notes:

For information on how to use DBD::SQLAnywhere, please invoke the
following after DBD::SQLAnywhere has been installed:

    perldoc DBD::SQLAnywhere

Prior to installation, you may instead run the following when
SQLAnywhere.pm is in your current directory:

    perldoc SQLAnywhere.pm

Examples can be found in the 'eg' directory:
    connect.pl  -> Demonstrates a simple connect.
    retrieve.pl -> Demonstrates retrieving data from a table and displaying the result set.
    blobs.pl    -> Demonstrates the use of blobs

For further examples, consult the test scripts located in the 't'
directory.

