wmbutton - Version 0.2

	Original Author: 
		Edward H. Flora <ehflora@ksu.edu>

	Contributors:
		Ben Cohen <buddog@aztec.asu.edu>
		Thomas Nemeth <tnemeth@multimania.com>

A simple dockable Application Launcher for use in Window Maker.
---------------------------------------------------------------------------

INSTALL:
--------
	Untar the file: 
		tar xvzf wmbutton-0.2.tar.gz
	CD to src dir:  
		cd wmbutton-0.2

	Edit background xpm, and buttons.xpm to your preferences

	Compile it:
	 	make

	Copy the config file:
		cp .wmbutton ~

	Put the executable somewhere:
		mv wmbutton /usr/local/bin (or anyhere in your path)
	
	Run it:
		wmbutton &

	Grab the appicon and move it to the dock. 
	Change the settings to start with Windowmaker

    ***Note***: 
	The appicon has only a two pixel border where you can grab 
	and move it.

	If make doesn't work, you may need to fiddle with the settings in 
	the Makefile.

	Tested on: (Well, it runs, I don't know if 'Tested' is quite right...)
		WindowMaker-0.50.2
		X Clients: Red Hat 5.1, Kernel 2.0.36
		X Servers: XFree86

USAGE:
------
usage: wmbutton [-g geometry] [-d dpy] [-n workspaces] [-v] [-f config file] [-h]

-g    geometry:    ie: 64x64+10+10 ( Somewhat useless due to Withdrawn state ).
-d    dpy:         Display. ie: 127.0.0.1:0.0
-n    workspaces:  How many buttons to start with.
-v                 Verbose. 0=off (default 0), 1=on.
-f    config file: full path to configuration file
-h                 Help. This screen.

Left mouse button:
	Selects the application to launch.

Right / Middle mouse buttons:
	Change the number of buttons displayed.

NOTES:
------
This is a simple application launching tool for use in WindowMaker, and 
possibly Afterstep.  (Who knows, it should run for other window managers too, 
by why bother??  It is taken from wmcp, by Ben Cohen, and modified just
enough to run applications rather than send ALT-[1..9] key sequences to 
WindowMaker.  I'm sure there is quit a bit of code that is still there, but
is now meaningless.  This was written in a couple of hours, as my first
Dock App.  

The mini-icons must be combined into a single graphic, buttons.xpm.  The 
background border is defined in backdrop.xpm.  Both must be edited in your
favorite graphics editor (GIMP??), and then recompiled.  WMbuttons uses a
configuration file (usually ~/.wmbutton) for which applications to launch.
There is no need to restart wmbuttons when simply changing the configuration, 
as wmbutton searches the file whenever a button is pressed.

An example file is included, related to the the buttons.xpm graphic file.

This program is released under the GPL license and has been created by looking
a lot at the code for wmcp.

"C code.  C code run.  Run, code, run.
			PLEASE!?!?!?!?!?!?"

CHANGE LOG:
-----------
0.2	   Added single configuration file, user selectable.

0.1	   Origional version.
	   	Shamelessly taken from wmcp 1.2.5, 
		by Ben Cohen <buddog@aztec.asu.edu>

TODO:
-----
Make changing icons and/or background graphics easier.
Allow for less than 9 icons, 4 would be nicer on the mini-icon size.
Make Windomaker 'Balloon Help' report help on each of the 9 buttons,
rather than just wmbuttons itself, if possible.

BUGS:
-----
Probably Lots.  Send comments (preferably with fixes) to 
	<ehflora@ksu.edu>
Note:  	I am a graduate student trying to finish a thesis this Spring,
	so I am not likely to do a lot of work on this for a while.

Good Luck.

