This file gives a short description of the configuration possibilities of
bbappconf. This version of bbappconf only works with Blackbox.

Configuration options can be changed in bbappconf.bb.
Most likely you want to change some of these options.

The global configuration file can be found in /usr/pkg/share/bbtools/bbappconf.bb
A local configuration can be made by copying the bbappconf.bb file to
$HOME/.bbtools/bbappconf.bb and editing it.

** Configuring bbappconf **
------------------------

To be able to do something with windows we first have to identify them.
In bbappconf this is done using the X-Windows class hints.

A class hints consists of the application name and class.
Normally all windows of an application have the same class, different windows
of an application can have different names.

You can tell bbappconf to indentify a windows as follows:
bbappconf.x.classHint.class:    class
bbappconf.x.classHint.name:     name

You should at least define one of these, if both are defined both should match.
If you want to find out the class/name of a window, use xprop,
it will show you: WM_CLASS(STRING) = "name", "class"

After you have identified an application window you can tell bbappconf what
to do with it:
bbappconf.x.stick:              true or false
bbappconf.x.decorless:          true or false
bbappconf.x.startOnWorkspace:   1..number of workspaces

Stick: makes the window stick on all your desktops.
decorless: removes all decorations from a window, like titlebars.
startOnWorkspace: tells bbappconf to start a window on a certain workspace.

The bbappconf.bb configuration file shows some examples.

NOTE:

Some application let you change thier application name.
For example xterm: xterm -name <name>
You can use this to start different xterm windows on different workspaces.
