1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
-- README for XWinWM 0.0.x --
This is the README for XWinWM 0.0.x release.
XWinWM is a window manager for Cygwin/X's rootless mode.
XWinWM is based on Hackedbox.
WindowsWM extension is needed.
-- 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.
Quick Start:
------------
The quickest and easiest way to get HackedBox up and running is to run the
following commands:
# cd HackedBox-0.7.x
# ./configure
# make
# 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.
Configuring HackedBox:
---------------------
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.
Included utilities:
-------------------
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.
Third-party utilities:
----------------------
Supported Platforms:
--------------------
Linux 2.4.x PPC (glibc2.1)
Linux i686
WinNT (XFree cygwin)
FreeBSD 4.6-STABLE i686
Please email larry@scrudgeware.org for other success reports.
|
