z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

Note: Editor commands do not have the same notion of a word as does the tcsh
shell. The editor delimits words with any non-alphanumeric characters not in
the shell variable wordchars, while the tcsh shell recognizes only whitespace
and some of the characters with special meanings to it, listed under
“Command syntax” on page 636.
Completion and listing
The tcsh shell is often able to complete words when given a unique abbreviation.
Type part of a word (for example ls /usr/lost) and press the tab key to run the
complete-word editor command. The shell completes the filename /usr/lost to
/usr/lost+found/, replacing the incomplete word with the complete word in the input
buffer. (Note the terminal / (forward slash); completion adds a / to the end of
completed directories and a space to the end of other completed words, to speed
typing and provide a visual indicator of successful completion. The addsuffix shell
variable can be unset to prevent this.) If no match is found (for example,
/usr/lost+found doesn’t exist), the terminal bell rings. If the word is already
complete (for example, there is a /usr/lost on your system, or you were thinking too
far ahead and typed the whole thing), a / or space is added to the end if it isn’t
already there.
Completion works anywhere in the line, not just at the end; completed text pushes
the rest of the line to the right. Completion in the middle of a word often results in
leftover characters to the right of the cursor which need to be deleted.
Commands and variables can be completed in much the same way. For example,
typing em [tab] would complete ’em’ to ’emacs’ if emacs were the only command
on your system beginning with ’em’. Completion can find a command in any
directory in the path or if given a full pathname. Typing echo $ar[tab] would
complete ’$ar’ to ’$argv’ if no other variable began with ’ar’.
The shell parses the input buffer to determine whether the word you want to
complete should be completed as a filename, command or variable. The first word
in the buffer and the first word following ’;’, ’|’, ’|&’, ’&&’ or ’||’ is considered to be a
command. A word beginning with ’$’ is considered to be a variable. Anything else is
a filename. An empty line is completed as a filename.
You can list the possible completions of a word at any time by typing ^D to run the
delete-char-or-list-or-eof editor command. The tcsh shell lists the possible
completions using the ls-F built-in and reprints the prompt and unfinished command
line, for example:
> ls /usr/l[’^D]
lbin/ lib/ local/ lost+found/
> ls /usr/l
If the autolist shell variable is set, the tcsh shell lists the remaining choices (if any)
whenever completion fails:
> set autolist
> nm /usr/lib/libt[tab]
libtermcap.a@ libtermlib.a@
> nm /usr/lib/libterm
tcsh
If autolist is set to ambiguous, choices are listed only if multiple matches are
possible, and if the completion adds no new characters to the name to be matched.
Chapter 2. Shell command descriptions 629