wmbutton Ver. 0 Rel 4
-------------------------------------------------------------
   Code is based on wmppp, wmload, wmtime, wmcp, and asbutton
   Author: Edward H. Flora <ehflora@ksu.edu>
   Ver 0 Rel 4    March 8, 1999

DESCRIPTION:
------------
wmbutton is a simple application launching program that sits in the
dock in WindowMaker, can be swallowed by Wharf in Afterstep, and
should be fairly configurable.

LICENSING:
----------
This program is released under the GPL license.  A copy (in case you
don't already have hundreds of then floating around) can be found in
this distribution in the file COPYING

CONTRIBUTORS:
-------------
              Ben Cohen <buddog@aztec.asu.edu>
                  original author of wmcp (et al.)
              Thomas Nemeth <tnemeth@multimania.com>
                  contributor to wmcp
              Casey Harkins <charkins@cs.wisc.edu> 
                  Bug fix reading config file path - 3/6/99
                  Added button-presses, and other - denoted by *charkins*
              Michael Henderson <mghenderson@lanl.gov>
                  Application ideas, suggestions
              Ryan ?? <pancake@mindspring.com> 
                  Modified wmbutton to asbutton.
                  Note: asbutton is a seperate program, not associated 
                        with wmbutton (just as wmbutton is not associated
                        with wmcp)
              Jon Bruno
                  Web Page Development
 The contributors listed above are not necessarily involved with the 
development of wmbutton.  I'm listing them here partially as thanks for 
helping out, catching bugs in the code, etc.

INSTALLATION:
-------------
	Untar the file: 
		tar xvzf wmbutton-0.4.tar.gz

	CD to source directory:  
		cd wmbutton-0.4

	Edit background xpm, and buttons.xpm to your preferences
	There are icon files in ./icons to work from

	Compile it:
	 	make clean; make

	Copy the config file:
		cp .wmbutton ~

	Put the executable somewhere in your path:
		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

	Afterstep Wharf 1.6.??:
	*Wharf wmbutton -Swallow "wmbutton" wmbutton &

    ***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, 0.51
		Afterstep 1.6.?
		X Clients: Red Hat 5.1, Kernel 2.0.36, 2.0.35
		X Servers: XFree86 S3V 3.3.3.1

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

-g  <geometry>   Window Geometry - ie: 64x64+10+10
-d  <display>    Display -  ie: 127.0.0.1:0.0
-f  <filename>   Full path to configuration file.
-v               Verbose Mode. 
-h               Help. This message.
-m               Enable Middle Mouse functionality.

Left mouse button:
	Selects the application to launch, numbered 1 through 9

Middle mouse button: (If enabled (-m))
	Selects the application to launch, numbered 11 through 19

Right mouse button:
	Selects the application to launch, numbered 21 through 29

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.  It has also taken some ideas from asbuttons, and
included them back into the original.  There may still be some code
left over from wmcp that is no longer needed, but...  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.

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

CHANGE LOG:
-----------
0.4	Added Modifications submitted by Casey Harkins. 
	  Start application on mouse button release, 
	  Only start app if cursor is still on application button
	  Added 3-D button press look
	Added new .wmbutton configuration file

0.3	Graphics changed to incorporate most changes made by asbutton
	Removed Middle/Right mouse click on button to turn off buttons
	  after it.
	Added Middle and Right mouse buttons to run more Applications
	  (Yes, you can now really run 27 different Apps from a single 
	  instance of wmbuttons, if you would want too...)
	Fixed bug for finding config file .wmbutton.
	  It used to not look in the home directory, but in the
	  startup directory.  Thanks to Casey harkins for the fix.
	Included the icons directory from the asbutton distribution,
	  plus a few more.

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.

BUGS: 
-----
Remember, they're just undocumented FEATURES!!!

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.



