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