Some man pages.

This commit is contained in:
rsc 2005-01-03 06:40:20 +00:00
parent 2600337aa7
commit 058b0118a5
214 changed files with 17112 additions and 1999 deletions

71
man/man1/label.1 Normal file
View file

@ -0,0 +1,71 @@
.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.