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