* General Commands - @(#)comhelp.dat 2.2 05/11/99 *


* COMINTERP or REDUCER only - !NOT RTSHELL!


ALIAS [ string1 [ string2 ] ] - create or display alias strings for commands.
CAT command - Passes `command' on to the catalog process command executor.
CD [ dirname ] - Change the user's current directory to dirname.
COMFILE filename [ echo ] - Execute commands from file `filename'.
EDIT filename - Calls an editor, according to environment variable VISUAL.
EXIT - Leave the command interpreter.
EXPAND input-line - The entire input line is expanded by alias substitutions.
HELP [ string1 [string2 ... ]] - Get successive levels of helping information.
KILL.SETUP - Completes the shutdown of the data-taking processes after EXIT.
LOG-OFF - Turns off the copying of output to the log file. (Default state)
LOG-ON - Turns on the copying of output to the log file. See also PRINT.
LOG-REWIND - Discards the current log file. Does not affect the LOG-ON or -OFF.
LS [ args ] - print directory listing. See the standard Unix `ls(1)' command.
PDD - Prints the currnet Data Directory. This is an alias for `dlink ?'.
PRINT [ command ] - Prints the log file. See also LOG-ON, LOG-OFF, LOG-REWIND.
PUD - Verbosely prints the current User Directory.
PWD - Calls the systems `pwd' to Print Working Directory. Similar to PUD.
READALIAS filename - Read aliases from file `filename' instead of the keyboard.
UDIR [options] [dirname] - Long form listing of the user's current directory.
UDIRS [options] [dirname] - List the current user directory (see CD).
UNALIAS string - deletes the alias `string' from the list.
VERBOSE - Toggles between verbose state and non-verbose state (default).
WRITEALIAS filename - Write all current aliases to file `filename'.

ALIAS [ string1 [ string2 ] ] - create or display alias strings for commands. With no arguments, list all defined aliases. With one argument, show the alias for string1. With two arguments, create (or replace) an alias for string1 with string2. NOTE: string2 consists of the rest of the input line up to its end, in contrast to most commands, which can be separated by semicolons (';').

CAT command - Passes `command' on to the catalog process command executor. Type HELP CAT for a list of catalog commands, or HELP CAT XXXXX for more help on command XXXXX.

CD [ dirname ] - Change the user's current directory to dirname. `Dirname' may be any valid path, absolute or relative to the user's current directory. If dirname is not given, this changes to the user's home directory as defined in the environment variable `HOME'. The resulting directory name is echoed, so typing `cd .' tells you which directory you're in at the moment.

COMFILE filename [ echo ] - Execute commands from file `filename'. The commands are executed just as if typed from the keyboard. Alias commands can be made as well. See also READALIAS.

EDIT filename - Calls an editor, according to environment variable VISUAL. If VISUAL is not set, it tries environment variable `EDITOR'. If that isn't set, the default editor is `vi'.

EXIT - Leave the command interpreter.

EXPAND input-line - The entire input line is expanded by alias substitutions. This shows the full commands that are really being executed. Note that it is not executed, just printed.

HELP [ string1 [string2 ... ]] - Get successive levels of helping information. Typing `HELP ?' shows which lower-level help trees exist (e.g. for the Reticon, IR array, Catalogs, etc.).

KILL.SETUP - Completes the shutdown of the data-taking processes after EXIT. This is not actually a command issued inside the command interpreter, but is included here for completeness. After the command interpreter is EXITed, killing the interpreter and instrument control processes, issuing this command will kill the rest of the processes and other resources associtaed with the real-time data system.

LOG-OFF - Turns off the copying of output to the log file. (Default state)

LOG-ON - Turns on the copying of output to the log file. See also PRINT.

LOG-REWIND - Discards the current log file. Does not affect the LOG-ON or -OFF.

LS [ args ] - print directory listing. See the standard Unix `ls(1)' command.

PDD - Prints the currnet Data Directory. This is an alias for `dlink ?'.

PRINT [ command ] - Prints the log file. See also LOG-ON, LOG-OFF, LOG-REWIND. All output since the last LOG-ON or LOG-REWIND are saved on a log file, and the PRINT command prints it. If `command' is given, that command is substituted instead of the usual `PRINT'. Thus, typing `print print80' will print 80-column output instead of two-up.

PUD - Verbosely prints the current User Directory.

PWD - Calls the systems `pwd' to Print Working Directory. Similar to PUD.

READALIAS filename - Read aliases from file `filename' instead of the keyboard. The aliases are read in from the file exactly as if they had been typed in, except that lines with an octothorp (`#') in the first column are considered a comment and ignored. Also, any line not beginning with `alias' is ignored, so that READALIAS can be used to, for example, gather only the aliases from any command file.

UDIR [options] [dirname] - Long form listing of the user's current directory. This is the same as `udirs -l'. Other options are the same as for the UNIX utility `ls(1)'.

UDIRS [options] [dirname] - List the current user directory (see CD). The options are the same as for the UNIX utility `ls(1)'.

UNALIAS string - deletes the alias `string' from the list.

VERBOSE - Toggles between verbose state and non-verbose state (default). When in verbose state, echoes the expanded string before executing it.

WRITEALIAS filename - Write all current aliases to file `filename'. A comment with the current date and time is written at the top of the file. If the file already exists, the user is prompted to confirm before the file is overwritten.