                  Gardens Point Modula Compilers
		  ------------------------------

The compilers available in this directory are licensed commercial products.
You are welcome to use them and distribute free copies of them for trial or
educational use.  They must not be resold or distributed for sale with other
programs which are for sale.  See SUPPORT.DOC for information about obtaining
the commercial package from a GPM distributor.

This software is distributed WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


File locations:
  ftp.fit.qut.edu.au:/pub/gpm/
  ftp.psg.com:/pub/modula-2/gpm/
  pegasus.dvz.fh-aachen.de/pub/modula/gpm/


/manuals
A complete documentation set has been placed in this directory, comprising:
        Library Reference Manual
        User's Guide to GPM
        Modula-2 Language Reference Manual

Look for:
        modula.ps.zip   (GPM Modula-2 manual - Postscript)
        modula.tex.zip  (GPM Modula-2 manual - LaTex)
        oberon.ps.zip   (GPM Oberon-2 manual - Postscript)
        oberon.tex.zip  (GPM Oberon-2 manual - LaTex)


/release-notes
Release notes including installation instructions are in this directory:
        gpmpc.ps.zip    (GPM-PC interpreter notes)
        modula.ps.zip   (GPM Modula-2 for Linux, DJGPP, EMX)
        modula.tex.zip
        oberon.ps.zip   (GPM Oberon-2 for Linux, EMX)
        oberon.tex.zip

/contrib
Contributed Modula-2 source code and library interfaces

/sources
Source code for GPM library modules is available here.
        libsrc.tar.gz   (C and Modula-2 sources)
	mpp.tar.gz      (mpp - a Modula-2 pre-processor)


You may also obtain a bound copy of the manuals and release notes.
The cost including airmail postage is:
        US$ 60   to anywhere in the world
        UK# 40   to anywhere in the world
        DM  70   to anywhere in the world
        A$  60   in Australia and New Zealand only

Please make cheques or money orders payable to QUT Office of Commercial 
Services, and don't forget to mention whether you want a documentation set
for GPM-Linux (includes GPM-DJGPP, GPM-EMX) or GPM-PC and send it to:
        Office of Commercial Services
        Queensland University of Technology
        G.P.O. Box 2434
        Brisbane 4001
        Australia


If you have e-mail access, we urge you to join the GPM mailing list.
It provides a forum for queries about the GPM compiler implementations,
bug and update reports and discussions on possible enhancements.
To join the mailing list, send mail to majordomo@dstc.qut.edu.au with the
body of the message containing:
    subscribe gpm
    help
    end

Any mail sent to gpm@dstc.qut.edu.au will get automatically forwarded to
all subscribers on the list. The development team are of course subscribers. 


/linux-elf, /linux-a.out & /freeBSD
-----------------------------------
The Linux and FreeBSD versions of the GPM languages produce assembly language
as output, compatible with GNU utilities such as gas and gdb.  They also use
the standard libc.a archive.  Thus they require the host system to have a
version of gcc installed on it.  GPM uses the same procedure calling
conventions as gcc for easy interfacing to foreign language modules.

Quick installation - Modula-2:
1) Create an installation directory, say /gpm

2) In this directory extract the distribution
       tar -xf modula-jun95.tar

3) You will get the following directories
       admin/        contains man pages and verbose error message file
       bin/          put this directory on your PATH
       ISOlib/       standard library object files
       GPMlib/       various non-standard libraries
       ISOsym/       definition & symbol files relating to ISOlib
       GPMsym/       definition & symbol files relating to GPMlib
       sample/       contains some sample Modula-2 code including X11 demos

4) Apply any fixes that have the same date as the distribution
   in ascending order. e.g.
       tar -xf modula-jun95-fix01.tar
       tar -xf modula-jun95-fix02.tar

5) Set up PATH, M2SYM and M2LIB environment variables
   Be aware that another program called gpm may be installed on your machine.
   e.g.  PATH=$PATH:.../gpm/bin
	 M2LIB=.../gpm/GPMlib:.../gpm/ISOlib
         M2SYM=.../gpm/GPMsym:.../gpm/ISOsym


Oberon-2
This distribution requires some binaries and library modules from Modula-2.
Thus it requires that you install Modula-2 as well and add the $M2LIB path
to your O2LIB path.

Quick installation:
1) Create an installation directory, say gpo/

2) In this directory extract the distribution
       tar -xf oberon-apr95.tar

3) You will get the following directories
       bin/          put this directory on your PATH
       libsrc/       sources of some of the libraries (in C, M2 and Oberon)
       o2lib/        put this directory on your O2LIB environment variable
       o2sym/        put this directory on your O2SYM environment variable

4) Apply any fixes that have the same date as the distribution
   in ascending order.

5) Set up environment variables PATH, O2SYM and O2LIB as noted above
   e.g.  PATH=$PATH:.../gpo/bin
         O2LIB=.../gpo/o2lib:$M2LIB
         O2SYM=.../gpo/o2sym


/djgpp
------
The GPM languages in this directory are ports of the Linux versions running
under MS-DOS in 32-bit mode.  They require the GNU tools from the DJGPP
package ported by DJ Delorie <dj@delorie.com> and friends.  It can be found
at any Simtel mirror.  In Australia use:
  ftp://archie.au/micros/pc/simtel/vendors/djgpp
The primary site is:
  ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp

Quick installation - Modula-2:
1) Download and install the DJGPP V2.0 environment
     Read the Modula-2 release-notes if you want help with this.

2) Create an installation directory, say /gpm

3) In this directory extract the distribution
       unzip modula-jun95.zip

4) You will get the same directories as detailed for linux version

5) Apply any fixes that have the same date as the distribution
   in ascending order. e.g.
       unzip modula-jun95-fix01.zip

6) Set up environment variables PATH, M2SYM and M2LIB as for linux version
   e.g.  SET PATH=%PATH%;...\gpm\bin
         SET M2LIB=...\gpm\GPMlib;...\gpm\ISOlib
         SET M2SYM=...\gpm\GPMsym;...\gpm\ISOsym

Oberon-2
Follow the directions as for Linux using unzip instead of tar
and set up environment variables PATH, O2SYM and O2LIB.
   e.g.  SET PATH=%PATH%;...\gpo\bin
         SET O2LIB=...\gpo\o2lib;%M2LIB%
         SET O2SYM=...\gpo\o2sym


/emx
----
The GPM languages in this directory are ports of the Linux versions running
under OS/2.  They require GNU tools from the EMX package ported by Eberhard
Mattes <mattes@azu.informatik.uni-stuttgart.de> which can be found at:

 Australia:  ftp://ftp.latrobe.edu.au/archive-disk3/os2/os2/unix/emx09c
 USA:        ftp://hobbes.nmsu.edu/os2/unix/emx09c
 Europe:     ftp://ftp.uni-stuttgart.de/pub/systems/os2/emx-0.9c


GPM Modula-2 can be used to create OS/2 PM (Presentation Manager) programs
as well as stand-alone DOS programs, using the EMX package.

Quick installation - Modula-2:
1) Download and install the EMX environment
     Read the Modula-2 release-notes if you want help with this.

2) Create an installation directory, say /gpm

3) In this directory extract the distribution
       unzip modula-may95.zip

4) You will get the same directories as detailed for linux version

5) Apply any fixes that have the same date as the distribution
   in ascending order. e.g.
       unzip modula-may95-fix01.zip

6) Set up environment variables PATH, M2SYM and M2LIB as for DJGPP version
     Also place the bin directory on your LIBPATH so the DLL can be loaded

Oberon-2
Follow the directions as for DJGPP version


/gpmpc
------
GPM-PC is a version of GPM Modula-2 based on interpreted intermediate code.
This provides a full 32-bit compiler on any PC running MS-DOS.
See README.gpmpc and the release notes for more details.
