-- README for HackedBox 0.8.x --
This is the README for HackedBox 0.8.x release.
The source tree for HackedBox is comprised of five subdirectories:
data/ - this holds the default data files that HackedBox requires for proper operation doc/ - this holds the documentation files that explain the various aspects of HackedBox nls/ - this holds the message files used to generate message catalogs for different languages src/ - this holds the actual C++ source code for the window manager. util/ - this holds source code for small utility programs that help HackedBox do what it does best. epist/ - contains the source code for epistrophy, a keygrabber appliction. bbkeys/ - contains the source code for bbkeys, another keygrabber appliction.
The quickest and easiest way to get HackedBox up and running is to run the following commands:
# cd HackedBox-0.7.x
# su -c 'make install'
This will configure, compile and install HackedBox the quickest. For those who like to spend the extra 15 seconds reading ./configure --help, some compile time options can be turned on and off before the build.
For general information on GNU's ./configure, see the file INSTALL.
The next thing most users want to do after installing HackedBox is to configure the colors, fonts, menus, etc. to their liking. This is covered by the files data/README, data/README.menu and data/README.style. These files give detailed information on how to customize your new window manager.
Currently, the only included utilities are a program named bsetroot and a script called bsetbg. bsetroot is a replacement for xsetroot, minus a few options. The difference between xsetroot and bsetroot is that bsetroot has been coded for multiple screens (e.g. multi-headed displays), where as the stock xsetroot is not. The bsetbg script acts as a wrapper for most of the popular programs used to set background pixmaps, making it possible for styles to provide a machine-independent rootCommand.
Linux 2.4.x PPC (glibc2.1)
WinNT (XFree cygwin)
FreeBSD 4.6-STABLE i686
OpenBSD 3.2 (i386)
Please email firstname.lastname@example.org for other success reports.