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?"
