tlabel.1 - plan9port - [fork] Plan 9 from user space
 (HTM) git clone git://src.adamsgaard.dk/plan9port
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       tlabel.1 (1267B)
       ---
            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) .