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 inter-
preted 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
Page 1 Plan 9 (printed 11/18/25)
LABEL(1) LABEL(1)
Awd is also documented in acme(1).
Page 2 Plan 9 (printed 11/18/25)