| LABEL(1) | LABEL(1)
| NAME
| label, awd – set window label
SYNOPSIS
| `label` string `awd` [ sysname ]
DESCRIPTION
| Label sets the label of the current win (see acme(1)) or X terminal window (e.g., 9term(1) or xterm(1)) by echoing a special control sequence to standard output.
Acme and 9term windows assume the label is a directory name. When unrooted file names are plumbed in the window, they are evaluated relative to the directory named in the label.
The label may have a suffix `/−`sysname, which is not interpreted as part of the directory during plumbing. Awd sets the window name to the current directory with a `/−`sysname suffix, using the name of the current system by default.
EXAMPLE
| One can use the following sh(1) function to keep the label up-to-date in response to cd commands:
| `_cd () {
| \cd "$@" && case $− in *i*) awd esac
} alias cd=_cd cd .
`
Rc(1) installs a similar `fn cd` at startup if there is not already a function named `cd`:
| `fn cd {
| if(builtin cd $1){ if(flag i) $PLAN9/bin/9 awd || status='' status='' }
}`
SOURCE
| `/usr/local/plan9/bin/label /usr/local/plan9/bin/awd`
BUGS
| Awd is also documented in acme(1).