Some man pages.

1 files changed, 71 insertions, 0 deletions

diff --git a/man/man1/label.1 b/man/man1/label.1
new file mode 100644
index 00000000..0caf8d5c
--- /dev/null
+++ b/man/man1/label.1
@@ -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.