
Usage:
======

$ make
[copy the file buttonbox somewhere sensible]
$ buttonbox ~/.buttonbox.conf

If you do not supply a file name, buttonbox will attempt to load the
file ButtonBox.ad from the current directory.  The file ButtonBox.ad
in the source distribution contains a sample configuration; currently
configuration is undocumented but it is not hard to work it out.

If you want to exit buttonbox, you must kill the process manually.

What It Is:
===========

ButtonBox is a simple program for Unix machines running the X Window
System that allows the user to execute any shell command with a single
click.

This is the initial release, and hence there are many rough edges and
lots of poor implementation.  It is licensed under the GNU General
Public License.  If you use this code as the basis for something,
please let me know.

Currently the code uses the POSIX function `waitpid' to clean up child
processes.  The SVR4 function setsid is used to prevent the
termination of buttonbox from causing all the programs it launched to
quit.  Changes to ameliorate these dependencies will be made if there
is demand.

If you want to see countlesss irrelevant debugging messages, uncomment
the -DWANT_DEBUG from CFLAGS in the Makefile.

Configuration:
==============

See the file ButtonBox.ad for an example of how to configure
ButtonBox.

You can noy only specify global colours with:

*background: ...
*foreground: ...

and so on, but you can specify colours for individual buttons in the
same way as you do for ``command'' and ``title''.

--
Paul Collins <sneakums@eircom.net> - - - - - [ A&P,a&f ]
 GPG: 0A49 49A9 2932 0EE5 89B2  9EE0 3B65 7154 8131 1BCD
"What's that blue thing doing here?"

