*****************************************
*     README for xmodemlights v1.0      *
*             12 March 1998             *
*            david w. Tharp             *
*          dwtharp@netpci.com           *
*****************************************

Xmodemlights is a very simple Linux/X11 program whose sole purpose in life is to
look and function a lot like the little modem status indicator found on
Windows 95's taskbar, either with the little modem or the little monitors.
It's designed to look spiffy when swallowed into the AfterStep window manager's
Wharf.  Although it runs fine as a standalone, it looks kinda funny that way. 

It monitors ppp0, via the proc filesystem.

With xmodemlights, you can tell at a glance whether you're connected, and the 
send/receive status of the link.

The only required libraries are Xlib and xpm, along with the shape extension 
to X11.

To build the program, perform the following steps, from within the 
directory to which you've unpacked the distribution file:

	xmkmf                 # create the Makefile from the Imakefile

	./select              # choose the icon to use.
                * after this step, verify that there is a symbolic link
                  called xpm linked to either the modem or monitors directory.

	make                  # compile and link the program

Assuming that works, which it should, you'll have a binary called xmodemlights,
which you can stick anywhere you want to.

Ideally, it should be swallowed in the AfterStep's Wharf, by including 
a line similar to the following in your .steprc file, in the Wharf 
configuration section:

	*Wharf xmodemlights nil Swallow "xmodemlights" /usr/local/bin/xmodemlights &

Of course, you'll want to replace /usr/local/bin/ with the real path for the 
xmodemlights binary, if it's different.

Since I've used Linux's proc filesystem (/proc/net/dev), I have no idea (nor 
do I much care) if xmodemlights will run on any other platform.  It's 
ridiculously simple, though, so it should port easily to anything with X11.



