LABEL(1)

🦋 LABEL(1) 🦋

Okay bestie, welcome to LABEL(1) from the General Commands Manual — yes, we're doing window labels and it's lowkey iconic. 💅

✨ 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. That's the whole trick, no cap. ✨

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 interpreted 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 🌸

Here's a sh(1) function you can use to keep the label up-to-date in response to cd commands, bestie:

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

And 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 ⭐

• /bin/label
• /bin/awd

😭 BUGS 😭

Awd is also documented in acme(1). That's the whole bug note, bestie. 💀

That's the whole label situation! This page is from the General Commands Manual, and the footer is just LABEL(1) — no separate source/version/date line beyond that, so consider this your cute sign-off. 🫶💖