home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / modu1096.zip / README next >
Text File  |  1996-10-14  |  8KB  |  220 lines
  1.                   Gardens Point Modula Compilers
  2.           ------------------------------
  3.  
  4. The compilers available in this directory are licensed commercial products.
  5. You are welcome to use them and distribute free copies of them for trial or
  6. educational use.  They must not be resold or distributed for sale with other
  7. programs which are for sale.  See SUPPORT.DOC for information about obtaining
  8. the commercial package from a GPM distributor.
  9.  
  10. This software is distributed WITHOUT ANY WARRANTY; without even the implied
  11. warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  12.  
  13.  
  14. File locations:
  15.   ftp.fit.qut.edu.au:/pub/gpm/
  16.   ftp.psg.com:/pub/modula-2/gpm/
  17.   pegasus.dvz.fh-aachen.de/pub/modula/gpm/
  18.  
  19.  
  20. /manuals
  21. A complete documentation set has been placed in this directory, comprising:
  22.         Library Reference Manual
  23.         User's Guide to GPM
  24.         Modula-2 Language Reference Manual
  25.  
  26. Look for:
  27.         modula.ps.zip   (GPM Modula-2 manual - Postscript)
  28.         modula.tex.zip  (GPM Modula-2 manual - LaTex)
  29.         oberon.ps.zip   (GPM Oberon-2 manual - Postscript)
  30.         oberon.tex.zip  (GPM Oberon-2 manual - LaTex)
  31.  
  32.  
  33. /release-notes
  34. Release notes including installation instructions are in this directory:
  35.         gpmpc.ps.zip    (GPM-PC interpreter notes)
  36.         modula.ps.zip   (GPM Modula-2 for Linux, DJGPP, EMX)
  37.         modula.tex.zip
  38.         oberon.ps.zip   (GPM Oberon-2 for Linux, EMX)
  39.         oberon.tex.zip
  40.  
  41. /contrib
  42. Contributed Modula-2 source code and library interfaces
  43.  
  44. /sources
  45. Source code for GPM library modules is available here.
  46.         libsrc.tar.gz   (C and Modula-2 sources)
  47.     mpp.tar.gz      (mpp - a Modula-2 pre-processor)
  48.  
  49.  
  50. You may also obtain a bound copy of the manuals and release notes.
  51. The cost including airmail postage is:
  52.         US$ 60   to anywhere in the world
  53.         UK# 40   to anywhere in the world
  54.         DM  70   to anywhere in the world
  55.         A$  60   in Australia and New Zealand only
  56.  
  57. Please make cheques or money orders payable to QUT Office of Commercial 
  58. Services, and don't forget to mention whether you want a documentation set
  59. for GPM-Linux (includes GPM-DJGPP, GPM-EMX) or GPM-PC and send it to:
  60.         Office of Commercial Services
  61.         Queensland University of Technology
  62.         G.P.O. Box 2434
  63.         Brisbane 4001
  64.         Australia
  65.  
  66.  
  67. If you have e-mail access, we urge you to join the GPM mailing list.
  68. It provides a forum for queries about the GPM compiler implementations,
  69. bug and update reports and discussions on possible enhancements.
  70. To join the mailing list, send mail to majordomo@dstc.qut.edu.au with the
  71. body of the message containing:
  72.     subscribe gpm
  73.     help
  74.     end
  75.  
  76. Any mail sent to gpm@dstc.qut.edu.au will get automatically forwarded to
  77. all subscribers on the list. The development team are of course subscribers. 
  78.  
  79.  
  80. /linux-elf, /linux-a.out & /freeBSD
  81. -----------------------------------
  82. The Linux and FreeBSD versions of the GPM languages produce assembly language
  83. as output, compatible with GNU utilities such as gas and gdb.  They also use
  84. the standard libc.a archive.  Thus they require the host system to have a
  85. version of gcc installed on it.  GPM uses the same procedure calling
  86. conventions as gcc for easy interfacing to foreign language modules.
  87.  
  88. Quick installation - Modula-2:
  89. 1) Create an installation directory, say /gpm
  90.  
  91. 2) In this directory extract the distribution
  92.        tar -xf modula-jun95.tar
  93.  
  94. 3) You will get the following directories
  95.        admin/        contains man pages and verbose error message file
  96.        bin/          put this directory on your PATH
  97.        ISOlib/       standard library object files
  98.        GPMlib/       various non-standard libraries
  99.        ISOsym/       definition & symbol files relating to ISOlib
  100.        GPMsym/       definition & symbol files relating to GPMlib
  101.        sample/       contains some sample Modula-2 code including X11 demos
  102.  
  103. 4) Apply any fixes that have the same date as the distribution
  104.    in ascending order. e.g.
  105.        tar -xf modula-jun95-fix01.tar
  106.        tar -xf modula-jun95-fix02.tar
  107.  
  108. 5) Set up PATH, M2SYM and M2LIB environment variables
  109.    Be aware that another program called gpm may be installed on your machine.
  110.    e.g.  PATH=$PATH:.../gpm/bin
  111.      M2LIB=.../gpm/GPMlib:.../gpm/ISOlib
  112.          M2SYM=.../gpm/GPMsym:.../gpm/ISOsym
  113.  
  114.  
  115. Oberon-2
  116. This distribution requires some binaries and library modules from Modula-2.
  117. Thus it requires that you install Modula-2 as well and add the $M2LIB path
  118. to your O2LIB path.
  119.  
  120. Quick installation:
  121. 1) Create an installation directory, say gpo/
  122.  
  123. 2) In this directory extract the distribution
  124.        tar -xf oberon-apr95.tar
  125.  
  126. 3) You will get the following directories
  127.        bin/          put this directory on your PATH
  128.        libsrc/       sources of some of the libraries (in C, M2 and Oberon)
  129.        o2lib/        put this directory on your O2LIB environment variable
  130.        o2sym/        put this directory on your O2SYM environment variable
  131.  
  132. 4) Apply any fixes that have the same date as the distribution
  133.    in ascending order.
  134.  
  135. 5) Set up environment variables PATH, O2SYM and O2LIB as noted above
  136.    e.g.  PATH=$PATH:.../gpo/bin
  137.          O2LIB=.../gpo/o2lib:$M2LIB
  138.          O2SYM=.../gpo/o2sym
  139.  
  140.  
  141. /djgpp
  142. ------
  143. The GPM languages in this directory are ports of the Linux versions running
  144. under MS-DOS in 32-bit mode.  They require the GNU tools from the DJGPP
  145. package ported by DJ Delorie <dj@delorie.com> and friends.  It can be found
  146. at any Simtel mirror.  In Australia use:
  147.   ftp://archie.au/micros/pc/simtel/vendors/djgpp
  148. The primary site is:
  149.   ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp
  150.  
  151. Quick installation - Modula-2:
  152. 1) Download and install the DJGPP V2.0 environment
  153.      Read the Modula-2 release-notes if you want help with this.
  154.  
  155. 2) Create an installation directory, say /gpm
  156.  
  157. 3) In this directory extract the distribution
  158.        unzip modula-jun95.zip
  159.  
  160. 4) You will get the same directories as detailed for linux version
  161.  
  162. 5) Apply any fixes that have the same date as the distribution
  163.    in ascending order. e.g.
  164.        unzip modula-jun95-fix01.zip
  165.  
  166. 6) Set up environment variables PATH, M2SYM and M2LIB as for linux version
  167.    e.g.  SET PATH=%PATH%;...\gpm\bin
  168.          SET M2LIB=...\gpm\GPMlib;...\gpm\ISOlib
  169.          SET M2SYM=...\gpm\GPMsym;...\gpm\ISOsym
  170.  
  171. Oberon-2
  172. Follow the directions as for Linux using unzip instead of tar
  173. and set up environment variables PATH, O2SYM and O2LIB.
  174.    e.g.  SET PATH=%PATH%;...\gpo\bin
  175.          SET O2LIB=...\gpo\o2lib;%M2LIB%
  176.          SET O2SYM=...\gpo\o2sym
  177.  
  178.  
  179. /emx
  180. ----
  181. The GPM languages in this directory are ports of the Linux versions running
  182. under OS/2.  They require GNU tools from the EMX package ported by Eberhard
  183. Mattes <mattes@azu.informatik.uni-stuttgart.de> which can be found at:
  184.  
  185.  Australia:  ftp://ftp.latrobe.edu.au/archive-disk3/os2/os2/unix/emx09c
  186.  USA:        ftp://hobbes.nmsu.edu/os2/unix/emx09c
  187.  Europe:     ftp://ftp.uni-stuttgart.de/pub/systems/os2/emx-0.9c
  188.  
  189.  
  190. GPM Modula-2 can be used to create OS/2 PM (Presentation Manager) programs
  191. as well as stand-alone DOS programs, using the EMX package.
  192.  
  193. Quick installation - Modula-2:
  194. 1) Download and install the EMX environment
  195.      Read the Modula-2 release-notes if you want help with this.
  196.  
  197. 2) Create an installation directory, say /gpm
  198.  
  199. 3) In this directory extract the distribution
  200.        unzip modula-may95.zip
  201.  
  202. 4) You will get the same directories as detailed for linux version
  203.  
  204. 5) Apply any fixes that have the same date as the distribution
  205.    in ascending order. e.g.
  206.        unzip modula-may95-fix01.zip
  207.  
  208. 6) Set up environment variables PATH, M2SYM and M2LIB as for DJGPP version
  209.      Also place the bin directory on your LIBPATH so the DLL can be loaded
  210.  
  211. Oberon-2
  212. Follow the directions as for DJGPP version
  213.  
  214.  
  215. /gpmpc
  216. ------
  217. GPM-PC is a version of GPM Modula-2 based on interpreted intermediate code.
  218. This provides a full 32-bit compiler on any PC running MS-DOS.
  219. See README.gpmpc and the release notes for more details.
  220.