shithub: purgatorio

ref: b5bc6572b0a82c52ab04bcf25e1ed76700deb246
dir: /man/1/toolbar/

View raw version
.TH TOOLBAR 1
.SH NAME
toolbar \- window manager toolbar
.SH SYNOPSIS
.B wm/toolbar
[
.B -s
] [
.B -p
]
.SH DESCRIPTION
.I Toolbar
is designed to be run as the controlling application under
an instance of
.IR wm (1).
It runs an initialisation shell script,
provides a menu allowing the user to start new programs.
and shows icons representing windows that have been hidden.
.PP
When
.I toolbar
is started, it configures itself by means of the
.B /lib/wmsetup
shell script.
.I Toolbar
loads the shell
.IR sh (1),
and defines the following
shell built-in
commands before executing the script:
.HP
.B menu
.I title1
.RI [ title2]
.I command
.br
Insert an item at the top of the start menu.
.I Title1
is the text of the item on the main menu.
If
.I title2
is given then
.I title1
is a sub-menu with
.I title2
as the menu item.
.I Command
is executed by the shell whenever the item is selected.
An item with an empty command is displayed as a separator.
.HP
.B delmenu
.br
Forget all menu items.
.PP
The standard
.B /lib/wmsetup
script executes the script
.BI /usr/ username /lib/wmsetup ,
enabling each user to have their own window manager configuration.
.PP
Normally
.I toolbar
packs a menu button referring to the start menu at the left hand side of the tool bar.
The
.B -s
option suppresses that.
.PP
.I Toolbar
serves the shared
.I "snarf buffer"
used by cut and paste in
.IR wm (1)
applications,
except in hosted Inferno where the host's standard clipboard system is used instead,
via
.IR snarf (3).
If
.I toolbar
cannot find
.B /chan/snarf
or the
.B -p
option is given,
.I toolbar
will create its own snarf buffer, private to the set of
applications running under the current instance of
.IR wm (1).
.SH FILES
.TP
.B /lib/wmsetup
Initialisation shell-script.
.SH SOURCE
.B /appl/wm/toolbar.b
.SH "SEE ALSO"
.IR wm(1),
.IR tkclient (2),
.IR wmclient (2),
.IR toolbar (1),
.IR logon (1).