-- data/README for Blackbox - an X11 Window manager

The data/ directory holds some menu and style (or theme) examples for
Blackbox.


The styles are installed as system defaults, and are ALWAYS
overwritten when upgrading or otherwise re-installing Blackbox.
Changes to them are discouraged, because of this reason.

In the data/ directory, you will find a directory named `styles.'
These are the system defaults that are installed when Blackbox is
built, and they are intended as examples on how to customize and
control the appearance of Blackbox.  In the event that a user does not
have a defined style, Blackbox falls back on the example styles
included here.

Also in the data/ directory is a file named `menu'.  This is meant as
an example but is also installed if make install detects that no menu
exists.  If blackbox is ever started without a valid menu the user
will get a backup menu which gives the ability to launch and xterm and
exit the window manager.

For information on creating/editing a menu, see the file README.menu.
For information on creating/editing a style, see the file
README.style.