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, firstname.lastname@example.org.