2005-01-03 06:40:20 +00:00
|
|
|
.TH LABEL 1
|
|
|
|
|
.SH NAME
|
|
|
|
|
label, awd \- set window label
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B label
|
|
|
|
|
.I string
|
|
|
|
|
.br
|
|
|
|
|
.B awd
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.I Label
|
|
|
|
|
sets the label of the current
|
|
|
|
|
.I win
|
|
|
|
|
(see
|
|
|
|
|
.IR acme (1))
|
|
|
|
|
or X terminal window
|
|
|
|
|
.RI ( e.g.,
|
|
|
|
|
.IR 9term (1)
|
|
|
|
|
or
|
|
|
|
|
.IR xterm (1))
|
|
|
|
|
by echoing a special control sequence to standard output.
|
|
|
|
|
.PP
|
|
|
|
|
.I Acme
|
|
|
|
|
and
|
|
|
|
|
.I 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.
|
|
|
|
|
.SH EXAMPLE
|
|
|
|
|
One can use the following
|
|
|
|
|
.IR sh (1)
|
|
|
|
|
function to keep the label up-to-date in response to
|
|
|
|
|
.I cd
|
|
|
|
|
commands:
|
|
|
|
|
.IP
|
|
|
|
|
.EX
|
|
|
|
|
_cd () {
|
|
|
|
|
\ecd "$@" &&
|
|
|
|
|
case $- in
|
|
|
|
|
*i*)
|
|
|
|
|
awd
|
|
|
|
|
esac
|
|
|
|
|
}
|
|
|
|
|
alias cd=_cd
|
|
|
|
|
cd .
|
|
|
|
|
.EE
|
|
|
|
|
.PP
|
|
|
|
|
.IR Rc (1)
|
|
|
|
|
installs a similar
|
|
|
|
|
.B fn
|
|
|
|
|
.B cd
|
|
|
|
|
at startup if there is not already a function named
|
|
|
|
|
.BR cd :
|
|
|
|
|
.IP
|
|
|
|
|
.EX
|
|
|
|
|
fn cd {
|
|
|
|
|
builtin cd $1 && flag i && awd
|
|
|
|
|
}
|
|
|
|
|
.EE
|
|
|
|
|
.SH SOURCE
|
2005-01-11 17:37:33 +00:00
|
|
|
.B \*9/bin/label
|
2005-01-03 06:40:20 +00:00
|
|
|
.br
|
2005-01-11 17:37:33 +00:00
|
|
|
.B \*9/bin/awd
|
2005-01-03 06:40:20 +00:00
|
|
|
.SH BUGS
|
|
|
|
|
.I Awd
|
|
|
|
|
is also documented in
|
|
|
|
|
.IR acme (1).
|
|
|
|
|
.PP
|
|
|
|
|
.I Awd
|
|
|
|
|
does not append the
|
|
|
|
|
.BI - label
|
|
|
|
|
suffix that it does on Plan 9.
|
