1 058b0118 2005-01-03 devnull .TH LABEL 1
 2 058b0118 2005-01-03 devnull .SH NAME
 3 058b0118 2005-01-03 devnull label, awd \- set window label
 4 058b0118 2005-01-03 devnull .SH SYNOPSIS
 5 058b0118 2005-01-03 devnull .B label
 6 058b0118 2005-01-03 devnull .I string
 7 058b0118 2005-01-03 devnull .br
 8 058b0118 2005-01-03 devnull .B awd
 9 058b0118 2005-01-03 devnull .SH DESCRIPTION
10 058b0118 2005-01-03 devnull .I Label
11 058b0118 2005-01-03 devnull sets the label of the current 
12 058b0118 2005-01-03 devnull .I win
13 058b0118 2005-01-03 devnull (see
14 058b0118 2005-01-03 devnull .IR acme (1))
15 058b0118 2005-01-03 devnull or X terminal window
16 058b0118 2005-01-03 devnull .RI ( e.g.,
17 058b0118 2005-01-03 devnull .IR 9term (1)
18 058b0118 2005-01-03 devnull or
19 058b0118 2005-01-03 devnull .IR xterm (1))
20 058b0118 2005-01-03 devnull by echoing a special control sequence to standard output.
21 058b0118 2005-01-03 devnull .PP
22 058b0118 2005-01-03 devnull .I Acme
23 058b0118 2005-01-03 devnull and
24 058b0118 2005-01-03 devnull .I 9term
25 058b0118 2005-01-03 devnull windows assume the label is a directory name.
26 058b0118 2005-01-03 devnull When unrooted file names are plumbed in the window,
27 058b0118 2005-01-03 devnull they are evaluated relative to the directory named in the label.
28 058b0118 2005-01-03 devnull .SH EXAMPLE
29 058b0118 2005-01-03 devnull One can use the following
30 058b0118 2005-01-03 devnull .IR sh (1)
31 058b0118 2005-01-03 devnull function to keep the label up-to-date in response to
32 058b0118 2005-01-03 devnull .I cd
33 058b0118 2005-01-03 devnull commands:
34 058b0118 2005-01-03 devnull .IP
35 058b0118 2005-01-03 devnull .EX
36 058b0118 2005-01-03 devnull _cd () {
37 058b0118 2005-01-03 devnull 	\ecd "$@" &&
38 058b0118 2005-01-03 devnull 	case $- in
39 058b0118 2005-01-03 devnull 	*i*)
40 058b0118 2005-01-03 devnull 		awd
41 058b0118 2005-01-03 devnull 	esac
42 058b0118 2005-01-03 devnull }
43 058b0118 2005-01-03 devnull alias cd=_cd
44 058b0118 2005-01-03 devnull cd .
45 058b0118 2005-01-03 devnull .EE
46 058b0118 2005-01-03 devnull .PP
47 058b0118 2005-01-03 devnull .IR Rc (1)
48 058b0118 2005-01-03 devnull installs a similar 
49 058b0118 2005-01-03 devnull .B fn
50 058b0118 2005-01-03 devnull .B cd
51 058b0118 2005-01-03 devnull at startup if there is not already a function named
52 058b0118 2005-01-03 devnull .BR cd :
53 058b0118 2005-01-03 devnull .IP
54 058b0118 2005-01-03 devnull .EX
55 058b0118 2005-01-03 devnull fn cd {
56 058b0118 2005-01-03 devnull 	builtin cd $1 && flag i && awd
57 058b0118 2005-01-03 devnull }
58 058b0118 2005-01-03 devnull .EE
59 058b0118 2005-01-03 devnull .SH SOURCE
60 c3674de4 2005-01-11 devnull .B \*9/bin/label
61 058b0118 2005-01-03 devnull .br
62 c3674de4 2005-01-11 devnull .B \*9/bin/awd
63 058b0118 2005-01-03 devnull .SH BUGS
64 058b0118 2005-01-03 devnull .I Awd
65 058b0118 2005-01-03 devnull is also documented in
66 058b0118 2005-01-03 devnull .IR acme (1).
67 058b0118 2005-01-03 devnull .PP
68 058b0118 2005-01-03 devnull .I Awd
69 058b0118 2005-01-03 devnull does not append the
70 058b0118 2005-01-03 devnull .BI - label
71 058b0118 2005-01-03 devnull suffix that it does on Plan 9.