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