Fame Perl Extension 2.0d
                         ------------------------

                              Fernando Trias

                             ftrias@fmrco.com
                       http://www.netcom.com/~trias

            Parts of this software are in the public domain.
            Changes and additions are Copyright 1995-1997 by 
            Fernando Trias. All rights reserved.

------------------------------------------------------------------------
    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU license or the Artistic
    License, a copy of which can be found with the perl distribution.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    license for more details.
------------------------------------------------------------------------

Fameperl contains FAME extensions for Perl 5.  FAME is a registered
trademark of FAME Information Services Inc.  Neither this program nor
its author are associated with Fame Information Services Inc, nor does
the author guarantee this software in any way.  This license does
not in any way grant you rights to use the FAME software.  You must
already have a FAME license which authorizes the use of CHLI.

This software is derived from public domain work done at the
Board of Governors of the Federal Reserve System, Washington, DC.

This software requires Perl version 5.002 or above.  A simpler, public
domain version for perl 4.036 is available from the author or the
Federal Reserve Board.  This program also requires FAME 7.6 (see
FAME 7.5 section below if you are using that version).  An extension to
TCL is also available.

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

INSTALLATION
------------

1. Set the FAME environment variable.

2. Check Makefile.PL to make sure directories are correct.  If you want
   to use the FRB extensions available at the Federal Reserve, add a
   "-DFRB" to the "DEFINES" section. See DEFINES below for more options. 
   Making changes to the defines may require manually adding or
   removing entries to the @EXPORTS array in file Fame.pm.  Also look
   at the Makefile.PL file in the LANG, DB, and HLI directories.

3. Extract the Makefile by running "perl Makefile.PL".

4. Run "make".

   a) IMPORTANT:  If you have problems running the test, particularly if
      you get an "Illegal Instruction" or "Bus Error" message, then you
      may have to patch the Perl executable to remove a name ("Errors")
      which conflicts with the Fame library.  Run "make patchperl" and
      try "make test" again.  This patch should not affect the 
      functionality of perl or any extensions.  After you verify that
      perl works, make sure to copy it to your production directory
      (such as /usr/local/bin).

      SOLARIS: "Error" does not have a "_" in front of it.  You will have
      to run "make patchsolaris".

5. If everything builds OK, run "make test" to perform rudimentary
   tests.

6. To install everything into production, you may run "make install".

MAKEFILE DEFINES
----------------

     FRB        Include FRB extensions.
     HLILIB     Include $FAME/demo/hli/chlilib.c support which
                includes various utilities to get text representations
                for errors, frequencies, etc.
     HLI75      Include support for new Fame 7.5 functions.
     UNSUP      Include undocumented and unsupported functions.


DOCUMENTATION
-------------

"Fame.pod" contains the current manual.  There is also a file
"Paper.doc" which contains an introductory paper about the perl 4
interface, but not any of the new object-oriented features added to
the perl 5 interface. "HLI/usage.doc" contains a summary of the HLI
package functions.


VERSIONS
--------

7.5 : To use FAME 7.5 you may have to modify some of the files during
the make process.  After step 4 ("make"), you will probably get an error
such as "famecons.i: syntax error at or near word 'extern'."  You will
have to find the line where the error occurred, which will probably be
in a "case" statement, and remove it.  Then type "make" again.

7.7 : The file $FAME/demo/hli/chlilib.c has more symbols than are
given in $FAME/hli/hli.h.  You must remove all the "case" entries
in chlilib.c which deal with FlexLm errors (they begin with "HFLX"),
or not set HLILIB in HLI/Makefile.PL.

This package has been built on SunOS and Solaris with FAME versions 7.0
to 7.7 with minor changes.  Contact the author for specifics if you
are having trouble.  This package has also been built for Windows NT and
95.


CONTACT INFO
------------

This software is being enhanced all the time in order to fix bugs,
keep up with FAME and perl changes, or add new features.  If you use
this software, please let the author know, so he can help keep you
up-to-date.  The author also provides installation assistance,
classes, and contract programming (please ask for information about
these services specifically).  Also, the author keeps an older version
of this software for TCL.

Fernando Trias 
<ftrias@fmrco.com>
132 1/2 Oxford St Apt 6
Cambridge, MA 02140
http://www.netcom.com/~trias


HLI.PH
------

hli.ph is obsolete and may not be supported in future releases of this
software.  It is provided now for compatability with older versions of
fameperl.

If you wish to maintain hli.ph in a different directory than the
original perl libraries, you may do one of two things:
 
1) You may wish to modify the perl 5 config.h file.  First, run
"Configure" and "make depend".  Then, assuming a directory of
/usr/local/lib/perl for your perl libraries, and
/usr/local/lib/fameperl for you fameperl specific files such as
hli.ph.  Modify the line which would read:
 
 #define PRIVLIB "/usr/local/lib/perl5"
 
to read:
 
 #define PRIVLIB "/usr/local/lib/perl5:/usr/local/lib/fameperl"
 
2) You may also use the PERLLIB or PERL5LIB environment variable.


MODULES LIST
------------

Part 2: 7) Database Interfaces (see also Data Types)

Fame           adcO  FAME database and language                   TRIAS

Part 4: 1)   Information / Contact Reference Details

  TRIAS  Fernando Trias <ftrias@fmrco.com>