This document introduces Gri, a program for creating science graphs.

First, the contents of the FTP directory are outlined briefly, and then information is given about the files containing PostScript Manual, the "info" manual, the source distribution and the binary distribution, the linux distribution, and the examples which appear in the manual.

1. Contents of Gri FTP Directory

This directory holds Gri, a program to plot science graphs. Several versions may be available, as indicated by numbers in the filenames. In the present file, the symbol N.N.N is used to indicate the version number. Contents of this directory:
 AUTHOR                              -- Information about author
 DISCUSSION                          -- Email discussion on gri newsgroup
 FAQ                                 -- Frequently asked questions, text
 FAQ.html                            -- Frequently asked questions, HTML
 History                             -- History of new features
 README                              -- What you are reading now, text
 README.html                         -- What you are reading now, text
 cmdrefcard.ps                       -- Commands ref card
 cookbook                            -- Contents of Gri cookbook
 fig2gri.gz                          -- Converts fig files to gri
 gri-N.N.N.tgz                       -- complete source, docs
 gri-N.N.N-1.i386.rpm                -- complete RedHat/linux package
 gri-binary-N.N.N-ibm-rs6000.tar.gz  -- Precompiled gri for IBM RS6000
 gri-binary-N.N.N-linux.tar.gz       -- Precompiled gri for linux
 gri-binary-N.N.N-sequent.tar.gz     -- Precompiled gri for sequent
 gri-binary-N.N.N-SunOS4.tar.gz      -- Precompiled gri for sun OS 4.x
 gri-binary-N.N.N-SunOS5.tar.gz      -- Precompiled gri for sun OS 5.x
 gri-examples-N.N.N.tar.gz           -- Examples from manual
 gri-manual-info-N.N.N.tar.gz        -- Manual in GNU texinfo form
 gri-manual-postscript-N.N.N.tar.gz  -- Manual in PostScript form
 gri-mode.el                         -- GNU emacs editing mode for Gri
 gri-source-N.N.N.tar.gz             -- C++ program source for Gri
 gri-source-beta.tar.gz              -- do not use unless author says to
 gritek-source.tar.gz                -- Tektronix Gri viewer (very poor)
 grix-source.tar.gz                  -- X11 Gri viewer (very poor)
 iso0.tar.gz                         -- Some isopycnals for TS diagrams
 refcard.ps.gz                       -- Overview reference card
Some of the files have numbers in their names, to indicate the version of Gri. Files ending in .gz are compressed with GZIP, while those ending in .tar.gz were created by TAR and then compressed. Here is an example of uncompressing and untarring a file archive:
    zcat gri-binary-SunOS5-2.1.10.tar.gz | tar xvf -
Note: The zcat decompression program can be acquired from any GNU site, e.g. from prep.ai.mit.edu in the pub/gnu directory.

2. Postscript Manual

The file with a name like gri-manual-postscript-N.N.N.tar.gz contains the complete Gri manual, in PostScript form. Also included are two reference cards, also in PostScript form.

The manual can be printed on any PostScript printer. On unix systems the command to print it is something like

    lpr -ps gri.ps

If your computer can preview PostScript (otherwise, you would not be using Gri!) then you might want to print just the table of contents and indices, and use these to navigate the online manual. This saves paper while letting you keep up-to-date with new versions of the manual.

3. Info Manual

The file with a name like gri-manual-info-N.N.N.tar.gz contains the complete Gri manual, in gziped, tared format. The manual is in the "info" format promoted by the Free Software Foundation. See your local documentation on installing "info" nodes.

4. Source Distribution

The file with a name like gri-source-N.N.N.tar.gz contains the complete source for Gri, in gziped, tared format. (The number gives the version number of this issue of Gri.) See above for instructions in unzipping and untaring the gri-source-N.N.N.tar.gz file. After this is done, youll have a local directory called src-VERSION which contains the Gri source code (plus an ancillary startup file called gri.cmd ). Read the file INSTALL to see how to install Gri on your machine.

5. Binary Distribution

Precompiled versions of Gri are available for several platforms. See files like gri-binary-SunOS5-N.N.N.tar.gz, etc. Here is how to extract gri and install it:

  1. Extract the archive, by typing e.g
        zcat gri-binary-SunOS5-2.1.10.tar.gz | tar xvf -
    
    This will create a directory called gri-binary-SunOS5-2.1.10 which contains the precompiled (gri), the startup file (gri.cmd), a Makefile to install Gri, and a documentation file called README.
  2. Follow the directions in the README file to install Gri.

6. Linux Distribution

The full program, with online documentation in `info' and `html' form, is available pre-configured for both RedHat and Debian flavors of linux. Since most linux distributions handle either RedHat or Debian packages, this means that these packages should work on all flavors of linux.

To install in RedHat, type e.g.

    rpm -i gri-2.2.0-1.i386.rpm
or, if another version of gri is already installed, you'd want to 'update' it, by typing
    rpm -U gri-2.2.0-1.i386.rpm
Removing Gri, not that you'd want to, is also trivial:
    rpm -e gri

7. Example Files

The files example1.gri, example2.gri, etc, are example Gri command files. To run them, creating PostScript files named example1.ps, example2.ps, etc, simply type make in the examples directory.