INSTALLATION

To install these modules, cd to the directory that contains all of the extracted 
distribution files, including this ReadMe file, and type the following:

        perl Makefile.PL
        make
        make test
        make install

The last step probably won't work if you are not the administrator of your 
machine; in that case you either need to get your administrator to install this 
for you, or put it in a your own local directory instead.

The Makefile.PL can do this for you if you substitute something like the 
following for the first line above:

        perl Makefile.PL PREFIX=/tmp/myperl5
        
or:

        perl Makefile.PL PREFIX=/home/me/myperl5

If you are on a Mac system that is older than Mac OS X (Mac OS 9 or earlier)
and/or you are otherwise having problems with the Makefile, you can still
install this module the old fashioned way, by copying.

Every file in the "lib" folder of this distribution goes in its corresponding 
location within the "lib" folder that came with your Perl 5 distribution.

Or alternately, put them anywhere you want, but you will need to have that 
location added to your include path by your main program using something like 
this:

        use lib '/home/me/myperl5/lib';

Then you would want to run the included test programs to make sure the modules
are installed correctly.  Call them like this:

        perl t/SQL_Routine.t

Any existing POD is embedded in the module itself.  The Makefile probably 
extracted it for you in the usual manner, or you can run a POD extractor on it 
yourself to the same effect.  You can also find an HTMLized copy of the POD on 
CPAN and other public source archives; I link to one copy of it on my web site.