mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-27 11:52:03 +00:00
72 lines
1 KiB
Groff
72 lines
1 KiB
Groff
|
.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
|
||
|
|
.B /usr/local/plan9/bin/label
|
||
|
|
.br
|
||
|
|
.B /usr/local/plan9/bin/awd
|
||
|
|
.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.
|