| .TH LABEL 1 | |
| .SH NAME | |
| label, awd \- set window label | |
| .SH SYNOPSIS | |
| .B label | |
| .I string | |
| .br | |
| .B awd | |
| .SH DESCRIPTION | |
| .I Label | |
| sets the label of the current | |
| .I win | |
| (see | |
| .IR acme (1)) | |
| or X terminal window | |
| .RI ( e.g., | |
| .IR 9term (1) | |
| or | |
| .IR xterm (1)) | |
| by echoing a special control sequence to standard output. | |
| .PP | |
| .I Acme | |
| and | |
| .I 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. | |
| .SH EXAMPLE | |
| One can use the following | |
| .IR sh (1) | |
| function to keep the label up-to-date in response to | |
| .I cd | |
| commands: | |
| .IP | |
| .EX | |
| _cd () { | |
| \ecd "$@" && | |
| case $- in | |
| *i*) | |
| awd | |
| esac | |
| } | |
| alias cd=_cd | |
| cd . | |
| .EE | |
| .PP | |
| .IR Rc (1) | |
| installs a similar | |
| .B fn | |
| .B cd | |
| at startup if there is not already a function named | |
| .BR cd : | |
| .IP | |
| .EX | |
| fn cd { | |
| builtin cd $1 && flag i && awd | |
| } | |
| .EE | |
| .SH SOURCE | |
| .B \*9/bin/label | |
| .br | |
| .B \*9/bin/awd | |
| .SH BUGS | |
| .I Awd | |
| is also documented in | |
| .IR acme (1). | |
| .PP | |
| .I Awd | |
| does not append the | |
| .BI - label | |
| suffix that it does on Plan 9. |