#+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
#+   
#+     Mumps Compiler 
#+     Copyright (C) A.D. 2004, 2008 by Kevin C. O'Kane  
#+
#+     Kevin C. O'Kane
#+     Department of Computer Science
#+     University of Northern Iowa
#+     Cedar Falls, IA 50613-0507 USA
#+
#+     okane@cs.uni.edu
#+     http://www.cs.uni.edu/~okane
#+
#+
#+ This program is free software; you can redistribute it and/or modify
#+ it under the terms of the GNU General Public License as published by
#+ the Free Software Foundation; either version 2 of the License, or
#+ (at your option) any later version.
#+ 
#+ 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
#+ GNU General Public License for more details.
#+ 
#+ You should have received a copy of the GNU General Public License
#+ along with this program; if not, write to the Free Software
#+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#+
#++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Mumps Compiler

This software uses a very common installation method.
Execute commands prompted by "$" as a normal user;
execute commands prompted by "#" as the root user:

Installation
------------
$ ./configure prefix=/usr
$ make
# make install

Omit the "prefix=/usr" if you want the compiler stored
in "~/mumps_compiler".  If you do not include "prefix=/usr",
you do not need to be root for the "make install"

Other "configure" options:

--with-pgsql=DIR to enable PostgreSQL access
--with-pgdb=DIR to store globals in PostgreSQL

Note: DIR in above is the path to the directory containing the
      POSTGRESQL include files. /usr/include for Cygwin and
      /usr/include/postgresql for Ubuntu.

--with-includes=DIR to identify header dirs (Apple)
--with-libraries=DIR to identify libs (Apple)

--with-cache=VAL to set native globals cache
--with-cache=VAL to set native globals cache size [9]"
--with-ibuf=VAL to set max size interpreted program [32000]"
--with-strmax=VAL to set max internal string size 4096"
--with-block=VAL to set native btree block size 8192"

Removal
-------
# make uninstall

Clean up the source tree
------------------------
$ make clean

Dependencies/build requirements: The short story

   * You must install PCRE, the Perl-Compatible Regular Expressions library:
        http://www.pcre.org/
   * You may install the Postgres libraries for RDBMS support:
        http://db.cs.berkeley.edu/postgres.html

The software, as distributed, is set to
compile under Linux.  

June 18, 2008
