                  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


/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
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


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
subject line blank and 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 & /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.  All code compiled by 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
       libsrc/       sources of some of the C implemented libraries
       m2lib/        put this directory on your M2LIB environment variable
       m2sym/        put this directory on your M2SYM environment variable
       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 as noted above


Oberon-2
This distribution requires some binaries and library modules from Modula-2.
Thus it requires that you install Modula-2 as well and place the /m2lib
directory on 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.  O2LIB=.../gpo/o2lib:.../gpm/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 of the simtel mirrors:
  Oakland Univ:   oak.oakland.edu       /SimTel/msdos/djgpp
  St. Louis, MO:  wuarchive.wustl.edu   /systems/msdos/simtel/djgpp
  Corvalis, OR:   archive.orst.edu      /pub/mirrors/simtel/msdos/djgpp
  Australia:      archie.au             /micros/pc/simtel/vendors/djgpp
  England:        src.doc.ic.ac.uk      /pub/packages/simtel/djgpp
  Finland:        ftp.funet.fi          /pub/msdos/SimTel/djgpp
  France:         ftp.ibp.fr            /pub/pc/SimTel/msdos/djgpp
  Germany:        ftp.uni-paderborn.de  /SimTel/msdos/djgpp
  Hong Kong:      ftp.cs.cuhk.hk        /pub/simtel/msdos/djgpp
  Israel:         ftp.technion.ac.il    /pub/unsupported/dos/simtel/djgpp
  Poland:         ftp.cyf-kr.edu.pl     /pub/mirror/msdos/djgpp
  Sweden:         ftp.sunet.se          /pub/pc/mirror/SimTel/msdos/djgpp
  Switzerland:    ftp.switch.ch         /mirror/msdos/djgpp
  Taiwan:         nctuccca.edu.tw       /PC/simtel/djgpp
  Thailand:       ftp.nectec.or.th      /pub/mirrors/SimTel/msdos/djgpp

Quick installation - Modula-2:
1) Download and install the DJGPP 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 following directories
       admin/        contains man pages and verbose error message file
       bin/          put this directory on your PATH
       libsrc/       sources of some of the C implemented libraries
       m2lib/        put this directory on your M2LIB environment variable
       m2sym/        put this directory on your M2SYM environment variable
       sample/       contains some sample Modula-2 code including X11 demos

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 noted above


/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:
  ftp.informatik.tu-muenchen.de:/pub/comp/os/os2/devtools/emx+gcc
  ftp.uni-stuttgart.de:         /pub/systems/os2/
  src.doc.ic.ac.uk:             /pub/packages/os2/2_x/unix/gnu/
  ftp-os2.cdrom.com:            /pub/os2/32bit/unix/emx09a/
  ftp-os2.nmsu.edu:             /pub/os2/32bit/unix/emx09a/

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.
     (If you don't have an unzip you will need to get it from one of the
      Simtel sites listed above. UNZ512X2.EXE is one that runs under OS/2.)

2) Create an installation directory, say /gpm

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

4) You will get the following directories
       admin/        contains man pages and verbose error message file
       bin/          put this directory on your PATH and LIBPATH
       libsrc/       sources of some of the C implemented libraries
       m2lib/        put this directory on your M2LIB environment variable
       m2sym/        put this directory on your M2SYM environment variable
       sample/       contains some sample Modula-2 code including PM demos

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 LIBPATH, PATH, M2SYM and M2LIB as noted above


Oberon-2
This distribution requires some binaries and library modules from Modula-2.
Thus it requires that you install Modula-2 as well and place the /m2lib
directory on your O2LIB path.

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

2) In this directory extract the distribution
       unzip oberon-may95.zip

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 PATH, O2SYM and O2LIB as noted above
   e.g.  O2LIB=.../gpo/o2lib:.../gpm/m2lib
         O2SYM=.../gpo/o2sym

/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.
