#+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
#+   
#+     Mumps Compiler 
#+     Copyright (C) A.D. 2004 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
#+
#++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

INSTALLING MUMPS ON MAC OS 10.2

Mumps can now be installed on OS X, thanks to Apple's migration to its
BSD-like core operating system called Darwin.  A typical installation
of OS X does not provide many of the standard development packages,
but the instructions below will help you set up an environment suitable
for most Mumps programs.

Mumps for OS X does not at this time handle network connections.  If you
do not have OpenSSL installed, you may ignore any SSL errors encountered 
while installing Mumps.

Apart from installing missing software, installing Mumps on OS X should
differ little from installing Mumps on other Unix-family machines.  Please
consult INSTALL for other configuration directions.

1. Make sure you have Mac OS X installed with the BSD subsystem.  Mumps
   is designed to run on the Unix family of operating systems, and access
   to a command line and certain system binaries is essential.

2. Download and install the latest Developer Tools for Mac OS X from
   http://developer.apple.com.  This package contains gcc and other
   development tools.
   
3. Download the latest version of Fink from http://fink.sourceforge.net.
   Follow the directions to install and set up your shell environment 
   variables.  (Note the alternate directions for bash users.)

   Fink is similar to Debian's package manager and makes for easy install-
   ation of applications.  Anything installed with Fink will be placed
   in the /sw hierarchy by default -- this location is not conventional
   but should pose no problem for your Mumps installation.  (You may need
   to identify /sw as an additional directory to search for application
   includes and libraries.)

3. Install the Perl Compatible Regular Expression (PCRE) library using
   Fink.  

     $ sudo fink install pcre

   At the time of this writing, a manual, non-Fink installation of PCRE
   failed on a two-level namespace error.  The following link describes
   the problem in greater detail.

     http://developer.apple.com/techpubs/macosx/ReleaseNotes/TwoLevelNamespaces.html

   We recommend using Fink to bypass this error.

4. Install the Berkeley Database using Fink.

     $ sudo fink install db4

   It is probable that you have a version of db already installed on your 
   system.  Mumps requires a late version 3 or greater.  If you install a 
   newer version of db from the source files or using Fink, please note which
   directory you install into.  You will have to provide the path during
   the Mumps installation.

5. Install readline using Fink.

     $ sudo fink install readline

   Your next step, installing PostgreSQL, depends on readline functionality.

6. Install PostgreSQL from source.  The following link describes in detail
   the installation process.

     http://developer.apple.com/internet/macosx/postgres.html

7. Download and decompress Mumps v5.10.

     $ wget http://www.cs.uni.edu/~okane/source/mumpscompiler-5.10.src.tar.gz
     $ tar xvpfz mumpscompiler-5.10.src.tar.gz

8. Install Mumps.

     $ cd mumpsc
     $ ./configure --with-libraries=/sw/lib:/usr/local/pgsql/lib \ 
       --with-includes=/sw/include:/sw/include/db4:/usr/local/pgsql/lib
     $ make
     $ make install

   You can specify nonstandard locations of include and library files using
   the --with-includes and --with-libraries options.  If you installed all
   software using the directions provided here, the above example should
   work fine.  Consult INSTALL for more general Mumps installation inform-
   ation.
