################################################################################ #
# File name: README
# Project: DBD::Illustra
# Description: README file
#
# Author: Peter Haworth
# Date created: 11/08/1998
#
# sccs version: 1.9 last changed: 10/13/99 #
# Copyright (c) 1998 Institute of Physics Publishing # You may distribute under the terms of the Artistic License, # as distributed with perl, with the exception that it cannot be placed # on a CD-ROM or similar media for commercial distribution without the # prior approval of the author.
#
################################################################################

This is version 0.04 of DBD::Illustra.

Changes from version 0.03:

• Included dbd-illustra.pod. This is the text describing Illustra from Tim Bunce and Alligator Descartes' book about DBI, although it's not going to be included now, due to Illustra's unpopularity
• Support for bind parameters
• Support for reading large objects
• Return correct number of rows in all cases
• Partial $sth->{TYPE} support

INSTALLING

What you need to install this module:

        Perl version 5.004 or later
        DBI version 1.0 or later
        Illustra client library and include files
        An ANSI C compiler

If the environment variable $MI_HOME is not set, Makefile.PL will look in a couple of likely places (currently /opt/illustra and /usr/local/illustra). It is looking for the directories $MI_HOME/lib/ and $MI_HOME/h/ for libraries and include files, respectively. If these directories aren't found, you won't be able to compile the module.

With $MI_HOME set or using the default, type 'perl Makefile.PL' to build the makefile and 'make' to build the module. 'make install' will install.

TESTING

DBD::Illustra uses Jochen Wiedmann's test suite. Before running the test you should set the environment variables DBI_DSN, DBI_USER and DBI_PASS to give write access to a database on your system. DBI_DSN defaults to dbi:Illustra:test