August 29, 1999

   README file for OS/2 port of Generic Mapping Tools, Version 3.3.1

I have ported Paul Wessel and Walter Smith's Generic Mapping Tools,
Version 3.3.1, to OS/2 Warp. All features that exist under the Unix version
of GMT should be available under OS/2, including binary i/o associated
with stdin and stdout (which apparently is not available under the
currently-distributed Win32 version of GMT).

NOTE THAT THIS DISTRBUTION SHOULD ALSO WORK UNDER Win9x, if one uses the
RSX run-time libraries rather than the EMX run-time libraries. It likely
will not work properly under WinNT, as the RSX libraries apparently do
not permit access to long filenames under WinNT, but do under Win9x. Also
note that I haven't tested it under Win9x.

Note that this version of GMT is released under the GNU Public License.
(GMT 3.0 and earlier versions were not). Please read the file COPYING
which accompanies the distribution.

This build is a static build. There are disadvantages to this, notably
increased executable file size and load time. I am providing some notes
below on some features of the build for those who would like to rebuild
the distribution.

A user needs the following:

1.  The EMX development environment needs to be installed for the port to
    function. The run-time version is all that is required for simply
    using the routines; to recompile, one must have the full
    development suite of EMX installed. In addition, it will help greatly
    if one has many of the GNU Unix utilities available (such as cp, rm,
    cat, etc). These are all available online; read the file GMT331_OS2.html
    with a web browser for more details. I have built the OS/2 version
    using only a slightly-modified version of the Makefile that is supplied
    with the standard GMT distribution; to use it, you likely need GNU make
    for OS/2.

2.  I strongly suggest running GMT under a Unix shell, rather than under
   the OS/2 command processor. Shells such as tcsh, bash, ksh, etc. are
    all readily available for OS/2; which to use is largely a matter or
    preference. I don't do it, but running using a Rexx script should also
    work fine. When I tested the example scripts, I used the TC-shell for
    OS/2.


3.  The OS/2 distribution can be found at the ftp site ftp.geophysics.lanl.gov,
    in the directory pub/EES3/pub/gmt/GMT3.3.1. It should be found on Hobbes
    or LEO soon.

4.  Please read the file GMT331_OS2.html with a web browser for more details.


Allen Cogbill
Geophysics Group
Los Alamos National Laboratory
Los Alamos, NM 87545
ahc@lanl.gov
