NAME
       gc3 - Gram's Commander v3.3

SYNTAX
       gc3 [ flags ] [ <path1> [ <path2> ] ]


DESCRIPTION
       gc3 is a general-purpose, programmable file manager for UNIX and MS-DOS, similar in
       nature to the well-known DOS file manager `Norton Commander'.

       When started up, gc3 presents the user with two windows  containing  lists  of  the
       files  in  the directories specified by the path arguments, and two windows showing
       information about each of these paths. Each file list window has  an  arrow  shaped
       cursor  which  points  at  one  of  the  file  names. Further information about the
       pointed-at file is also shown in the information window. The  bottom  line  of  the
       screen is a one- line borderless command window for entering commands. This is also
       where error messages are displayed, and where gc3 commands can prompt for input.

       If a path argument(s) is missing, the current directory is used for  the  left-hand
       window,  while  the  path  for the right hand window will be the directory that was
       current when you last executed gc3.  This is  determined  from  the  initialisation
       file .gc3ini which also saves the last known value of options and variable settings
       upon exit.  gc3 searches for the initialisation path in the directory specified  by
       the $GCPATH environment variable. If this is not set the $HOME environment variable
       is used instead.

       The user can move through the file list with the cursor keys,  and  select/deselect
       files. Various actions are possible upon either the current file (namely the one at
       which the cursor is positioned) or upon the set of selected files  in  that  direc-
       tory.


       gc3  supports  a number of commands. The actual commands may vary from site to site
       (or from user to user). To find out the list of commands that gc3 supports at  your
       site, press the help key (usually H ).

       The  behaviour  of  gc3 is determined by a script file written in a language called
       GCScript.  Full details of the script files and how to configure gc3 can  be  found
       in  the  documentation  files  that  accompany the registered gc3 package. The file
       USER.DOC also contains considerably more detailed information about using gc3  than
       this manual entry does.



COMMAND LINE FLAGS
       -c          supresses the use of colour.


       -C          [<script>] forces a script recompile; the default script name if one is
                   not specified is `gc3.key'.


       -d          [ n ][ l ] writes a disassembled listing  of  the  compiled  script  to
                   stdout. The n option produces a numeric dump, while the l option causes
                   the link phase to be skipped.


       -D          <id> allows you to define identifiers for  conditional  compilation  of
                   the script (used with -C ).


       -i          shows the current instruction pointer value at bottom.


       -I          forces the gcinit function in the script to be called.


       -t          or  -T write an instruction trace to the file gc3.ip , useful for post-
                   mortem debugging.   -T starts the trace from the  execution  of  gcinit
                   while -t starts from the key processing loop.


       -v          causes the compiler to output more verbose messages.


THE DEFAULT SCRIPT FILE
       Under  UNIX, no lower-case letters other than j and k are bound. Thus, pressing any
       of these unbound keys causes the gcdefault function to be  called.   This  function
       invokes  the  command line editor after inserting the key that was pressed into the
       command line esitor buffer. You will see a prompt Command?  at the  bottom  of  the
       screen.  You can then complete the command and execute it by pressing ENTER. If you
       end the command with a pipe character | , the file pager  command  defined  by  the
       $pager  variable  will  automatically  be appended to the command line before it is
       executed.

       gc3 includes a hypertext help system with considerably more  information.  You  can
       enter  this help system by pressing Ctrl-B. The manual which accompanies registered
       versions of gc3 also has considerably more information.


THE COMMAND LINE EDITOR
       The default command line editor setup for UNIX is:


       ^F          insert current file name at cursor position


       ^L          Move cursor to left hand end (start) of line


       ^R           Move cursor to right-hand end of line


       Del         Delete the character under the cursor


       Backspace   Delete the character left of the cursor


       Ins         Toggle Ins/overstrike modes. You can see the  current  mode  as  a  `+'
                   (insert) or `-' (overstrike) at the right hand end of the command line


       ESC         Clear whole line


       ^E          Erase from start of line


       ^K          Kill to end of line


       ^P          Delete from start of previous word to cursor


       ^N          Delete to from cursor to start of next word


       ^B          Move cursor to previous word


       ^W          Move cursor to next word


       PgUp        Recall previous command in command history list


       PgDn        Recall next command in command history list


FILES
       $GCPATH/gc3.key
                   The script file that determines how gc3 behaves


       $GCPATH/.gc3ini
                   The  startup  file  containing  the last active path, option values and
                   variable values


       $GCPATH/.gc3cod
                   The compiled script code file


       $GCPATH/.gc3rul
                   The rules that gc3 uses to decide what editor and paginator to use, and
                   how to handle container files (such as tar, cpio and zip files).


       The gc3 User's Manual (registered users only)


       INSTALL.DOC The installation documentation


SEE ALSO
       The ed (1) editor.

       regexp (5)

       sel (l) a general argument selector


AUTHOR
       Graham Wheeler, gram@aztec.co.za.