    Welcome to wmium, the WindowMaker Internode Usage Meter!

While initially developed only for FreeBSD, wmium is now known to build and run
with/on the following systems and compilers (or at least has been built/run on
it in previous versions):

=> Operating systems:

o) FreeBSD 5.1
o) FreeBSD 4.6
o) NetBSD 1.6E
o) RedHat Linux 7.1
o) RedHat Linux 7.3
o) RedHat Linux 9*
o) Fedora Core 2
o) Mandrake Linux 8.2
o) Mandrake Linux 10.0
o) Gentoo Linux 1.2 (?)
o) Gentoo Linux 1.4
o) Debian (woody) Linux 3.0
o) Slackware Linux 10

=> Compilers:

o) g++ 2.95.3
o) g++ 2.95.4
o) g++ 2.96
o) g++ 3.2.2
o) g++ 3.3 (pre)

*) Note: On RedHat 9, you must use the following to build:
make CXXFLAGS=-I/usr/kerberos/include

If you successfully (or unsuccessfully) build and run wmium on a different
system, please let me know so that I can keep this list updated. It is my aim
to make wmium available on as many systems as possible (at least in the BSD
and Linux families). You'll find my email address further down in this file.

wmium needs the following libs in order to build and run, so if your build
fails, please ensure you have them installed before you try anything else.

o) X11R6 (with shape extensions)
o) Xpm
o) OpenSSL


If you just want to jump right in and see how it goes on your box, just:

make install

With a bit of luck that will work and you'll have wmium installed in the default
/usr/local/bin location. To specify a different location, use the PREFIX
variable to set it, like so:

make PREFIX=/my/other/path install

which will then install wmium as /my/other/path/bin/wmium.
Follow the instructions given at the end of the install to set up your resource
file for wmium properly, and then you're set to go :)


In case the build doesn't go as well as you'd like, I'm happy to accept patches
and will incorporate them as I go along. I'd appreciate if you could include
the output of

g++ -E -dM version.h

g++ --version

env

uname -a

uname -s

in your email. Of course, this assumes you're using g++ to compile. If you're
using something else, please use the appropriate commandline options to get
the default macro definitions and version.

If your C++ skills aren't good enough to come up with suitable patches
yourself, I can try and cater for your system if you send me the full log
of the build, together with the above requested information.
Please be aware that I cannot guarantee that I'll be able to make it run on
your particular system, and I also have a limited amount of time to dedicate
to this little project. But I'll try :)

Ah, yes, one last thing - my email address: lonewolf@internode.on.net
I'm happy to receive feedback and patches (and bugreports I guess *sigh*).
Spam me and thou shalt burn and wither in the nether regions of hell :)

-- Johny

