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).

Space Glenda