
Copyright (c) 2004 Jess Mahan <jess@digitalssg.net>

-----------------
WmWiFi      0.5
-----------------

 If your reading this, then you are probably running Window Maker, and have a 
 WmWifi (wireless) card installed on your Linux box.

 !!!! BE AWARE !!!!
 This is my first attempt at writing a Window Maker dockapp, so if this thing
 destroys your computer, kills your dog, or burns down your house, don't 
 blame me for it. This is very experimental at the moment.

 This dockapp displays the signal strength, link level, noise level, and bitrate
 to your current access point. It also displays the current access point's name.

 I sincerely apologize for any inconveniences for problems with the previous
 version(s) of WmWiFi. 
 
 Many thanks to the people to actually e-mailed me with bug reports, those bug
 reports have made this version possible. WmWiFi now works properly (i hope).

-----------------
Getting Help
-----------------

 If you need help, there is a mailing list at wmwifi@lists.digitalssg.net. 
 
 Simply subscribe to it by sending a blank e-mail to 
 wmwifi-subscribe@lists.digitalssg.net.

 When asking a question, please be sure to include the nature of your problem,
 and the output from the following commands:

 "cat /proc/net/wireless"
 "iwconfig"
 "head -10 /usr/include/linux/wireless.h | grep Version"
 
-----------------
Requirements
-----------------

 libXpm          http://freshmeat.net/projects/libxpm
 libdockapp      ftp://truffula.com/pub/libdockapp-0.4.tgz

 To compile this, you'll need libdockapp, libxpm, and all the X development 
 libs. Chances are, if you have installed other dockapps, then you will have 
 no problems compiling this.

 Linux Wireless Extensions.
 This program relys on the Wireless Extensions being enabled (and working) in
 the 2.4.X kernel series. If you can "cat /proc/net/wireless", then this thing
 will probably work for you. If "cat /proc/net/wireless" returns nothing, then
 this dockapp wont work.


-----------------
Building
-----------------

 Yup, you guessed it...
 If you have met all the *requirements* then just do:
 ./configure; make; make install


-----------------
The "Look"
-----------------

 This versions (0.5) of wmwifi still uses the look introduced by version 0.2.
 For now, you cannot change the look, and to be honest, there has been
 no complaints, so if you want a new look or have a kewl design, e-mail me.

 There were bug reports of the percentages not being displayed correctly, 
 this is my fault, since I assumed that the maximum link quality would
 always be 92. I had reports of varying link qualities, so in this version
 it should be fixed (if it's not, you know where to e-mail me). We not
 get the maximum link quality directly from the wireless extensions in the
 kernel, rather than assume it's 92.

 The Link quality of your card is now displayed as a percentage (0% - 100%).


-----------------
Stuff it does do 
-----------------

 
 WmWiFi now monitors all of you wireless interfaces. So if you have more
 than one, WmWiFi can now handle it!

 - Monitors all wireless interfaces attached to your machine
   (If you have the module(s) loaded)
 - Displays Link, Level, Noise, Bitrate, and Current Access Point
   for each interface.
   
 To switch to the next wireless interface, simply middle click (mouse 2).
 To switch to the next screen, simply right click (mouse 3).

-----------------
Stuff if doesn't do or can't do
-----------------

 WmWifi cannot properly report the stats from drivers like the prism54 or 
 ndiswrapper drivers. Believe me, I have tried to get these to work, but
 the stats don't even report correctly from iwconfig, so I am assuming it's
 not my fault.

 If you post to the mailing list complaining about wrong stats, and you are
 using one of those drivers, I'm going to slap you silly, because you didn't 
 read this!

 I did try and put some code in this version to "auto-learn" your link quality
 if the maximum cannot be read from the driver, but it's not guaranteed.

----------------- 
Rants / Raves
-----------------

 forward beer, pizza, scotch, smokes, or hate mail to jess@digitalssg.net
