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

tcsh: complete
This completion completes commands (words in position 0, p/0) which begin
with co (thus matching co*) to compress (the only word in the list). The leading
- indicates that this completion is to be used only with ambiguous commands.
3. This is an example of n-type completion. Any word following find and
immediately following -user is completed from the list of users.
> complete find ’n/-user/u/’
4. This demonstrates c-type completion. Any word following cc and beginning
with -I is completed as a directory. -I is not taken as part of the directory
because we used lowercase c.
> complete cc ’c/-I/d/’
5. Different lists are useful with different commands:
> complete alias ’p/1/a/’
> complete man ’p/*/c/’
> complete set ’p/1/s/’
> complete true ’p/1/x:Truth has no options./’
These complete words following alias with aliases, man with commands, and
set with shell variables. true doesn’t have any options, so x does nothing
when completion is attempted and prints ’Truth has no options.’ when
completion choices are listed.
The man example, and several other examples below, could just as well have
used c/* or n/* as p/*.
6. Words can be completed from a variable evaluated at completion time,
> complete ftp ’p/1/$hostnames/’
> set hostnames = (rtfm.mit.edu tesla.ee.cornell.edu)
> ftp [^D]
rtfm.mit.edu tesla.ee.cornell.edu
> ftp [^C]
> set hostnames = (rtfm.mit.edu tesla.ee.cornell.edu uunet.uu.net)
> ftp [^D]
rtfm.mit.edu tesla.ee.cornell.edu uunet.uu.net
or from a command run at completion time:
> complete kill ’p/*/’ps | awk \{print\ \$1\}’/’
> kill -9 [^D]
23113 23377 23380 23406 23429 23529 23530 PID
The complete command does not itself quote its arguments, so the braces,
space and $ in {print $1} must be quoted explicitly.
7. One command can have multiple completions:
> complete dbx ’p/2/(core)/’ ’p/*/c/’
This example completes the second argument to dbx with the word core and
all other arguments with commands. The positional completion is specified
before the next-word completion. Since completions are evaluated from left to
right, if the next-word completion were specified first it would always match
and the positional completion would never be executed. This is a common
mistake when defining a completion.
8. The select pattern is useful when a command takes only files with particular
forms as arguments. For example,
> complete cc ’p/*/f:*.[cao]/’
678 z/OS V1R9.0 UNIX System Services Command Reference
completes cc arguments only to files ending in .c, .a, or .o. select can also
exclude files, using negation of a glob-pattern as described under “Filename
substitution” on page 643.