PERL HBM
                               --------


           The HB extension to Perl and the Perl HB Module

		      Installation Instructions







1. GENERAL INSTRUCTIONS

    This file contains information on how to build and install the
    PerlHBM package.

    First you'll need to install the HB extension to Perl.  That will
    allow you to call functions in the HB library from your Perl script.
    The steps to do this are described in detail at the section 2 of
    this file.

    Once you have succesfully installed the HB extension to Perl, you can
    install the Perl HB module (that is, the Perl extension to HB).  It
    will allow you to embed Perl code within your HB scripts.

    If something goes wrong (and that is something likely to happen
    at this point of time), use your common sense and try to fix the
    Makefiles, sending me a complete report on the things you did so I
    can consider them for the next release.


2. INSTALLING THE HB EXTENSION TO PERL

    Synopsis:

        $ cd perlhb && perl Makefile.PL && make && make install

    Detailed instructions:

    1. Install HB.

       You can always obtain the latest version of HB from:

           <http://bachue.com/hb/hb.cgi/download>.

       Note that this release only works with versions above 1.9.8.

    2. Create the Makefile in the perlhb directory.

       Change to the perlhb directory in this distribution (and stay
       there until you have the extension installed) and issue the
       following command:

           $ perl Makefile.PL

       It will look for the hb-config script that came with HB in
       different directories and then create the Makefile, required in
       the steps below.

       If it fails to find hb-config (because you installed HB in an
       unusual location), set an HB_CONFIG environment variable with the
       full path to your hb-config script and pass it when you execute
       this command (the example works on Bash):

           $ HB_CONFIG="/home/azul/hb/bin/hb-config" perl Makefile.PL

    3. Compile the extension.
    
       Issue the following command:
       
           $ make

       It will look in the Makefile (created in step 2) for instructions
       on what to do.

    4. Install the extension

       To install the extension you need to issue the following command:

           $ make install

       You will usually do this as the super user, unless you installed
       Perl as a normal user.

       You can now `use HB;' in your Perl scripts.


3. INSTALLING THE PERL HB MODULE

    Synopsis:

    $ cd hbperl && make

    It should be noted that in order to use the Perl HB module, you'll
    need to install the HB extension to Perl. This is so because in
    order to do anything useful from the Perl code that HB will execute,
    you'll need to call some functions in HB.

    Detailed instructions:

    1. Compile the module

       Change to the hbperl directory and build the module:

           $ make

       If all goes well, you'll now have a `perl.so' file. You can load
       it in your HB files with the line:

           :lib /path/perl.so

       If something goes wrong, look at the output presented by the
       hb-config script and try to fix it (don't forget to send me a
       complete report so you won't have to fix it the next time HB
       is released).