LABEL(1)                                                 LABEL(1)

     NAME
          label, awd - set window label

     SYNOPSIS
          label string
          awd [ sysname ]

     DESCRIPTION
          Label sets the label of the current win (see acme(1)) or X
          terminal window (e.g., 9term(1) or xterm(1)) by echoing a
          special control sequence to standard output.

          Acme and 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.

          The label may have a suffix /-sysname, which is not inter-
          preted as part of the directory during plumbing.  Awd sets
          the window name to the current directory with a /-sysname
          suffix, using the name of the current system by default.

     EXAMPLE
          One can use the following sh(1) function to keep the label
          up-to-date in response to cd commands:

               _cd () {
                    \cd "$@" &&
                    case $- in
                    *i*)
                         awd
                    esac
               }
               alias cd=_cd
               cd .

          Rc(1) installs a similar fn cd at startup if there is not
          already a function named cd:

               fn cd {
                    if(builtin cd $1){
                         if(flag i) $PLAN9/bin/9 awd || status=''
                         status=''
                    }
               }

     SOURCE
          /usr/local/plan9/bin/label
          /usr/local/plan9/bin/awd

     BUGS

     Page 1                       Plan 9            (printed 12/22/24)

     LABEL(1)                                                 LABEL(1)

          Awd is also documented in acme(1).

     Page 2                       Plan 9            (printed 12/22/24)