README for Gram's Commander v3.1
=================================

I have been promising this release for quite a while now. Unfortunately
I have been busy, been overseas, been sick, etc, so I haven't been able
to give it all the time it deserves. It works under UNIX SVR4, HP-UX, and
on Crays; other platforms may or may not work.

I have decided to reelase gc3.1 at this point because it is becoming 
difficult for me to respond to problems reported by the beta testers 
without access to the same target systems as they are using. My hope
in releasing gc3.1 now is that other users who may have more programming
experience than some of the gc beta testers will be able to find the
problems for me and send me patches. Also, if I don't do it now, gc3.1
will probably *never* be released, due to time constraints.

Despite the fact that it hasn't been completely ported to all Unix
flavours, if you are a programmer familiar with your architecture you
should not have much difficulty getting the system going. In particular
I have kept the use of Curses routines to a minimum as this is a big
portability problem.

Please read the gc3.doc file for full details about gc3.1. The gc3 manual
entry is very terse and really just refers to the doc file as well.

For those who are familiar with gc, you will be pleased to know that
gc3.1 is a *major* improvement over gc2.x, mostly because it is now
almost completely controlled by a fairly powerful script language. To make
the most of gc3 you will want to familiarise yourself with the script
language and create your own gc3.key file.

For those who aren't, gc3 is essentially a window-based file manager 
program, but is very flexible due to the script language. In fact, gc3
is really an interpreter for a script language which also displays the
contents of two directories in two windows on the screen. Commands are
assigned to keys, and can be used to useful things like marking a set 
of files, applying an operation to a set of marked files, and so on.
Easy access to the command shell is provided so that you do not need
to quit gc3 to execute a normal shell command. gc3 is very useful for
file maintenance operations, and for DOS users who are new to UNIX but
are familiar with programs like Norton Commander, gc3 should be a treat.

If you have problems compiling gc3, or you notice bugs, please mail me
a report to gram@aim1.aztec.co.za. I will do my best to deal with these
soon and post patches. If you can fix a bug and send me a patch, even 
better. When reporting problems, please specify your hardware, operating
system, and compiler, as well as any errors or warnings reported by the
compiler. Also, specify what DEFINES, MISSING and LIBS you used in the
Makefile.

MAKE A BACKUP OF THIS VERSION OF GC3. This is important as any patches 
that get posted will be patches to the original file set.

This version of gc also runs under MS-DOS, although it is a bit flaky.

Share and enjoy!
Gram (Graham Wheeler)

Known bugs in this release
==========================

When I press the Del key in the command line editor gc3 hangs up.
Backspace works ok.

Under DOS gc3 is still flaky.



