widtools v2.0 Robert S. Mallozzi <mallozzir@cspar.uah.edu> 1999 Jan INTRODUCTION widtools is a small set of tools that allow you to use XForms widgets in your shell scripts. There are the following tools available: dialog getfile input menu showfile slider The structure of widtools has totally changed from that of v1.2. The new version is not backward compatible; sorry, but it cannot be helped. The older versions were flawed in their design (not that the new version isn't :-) ). Anyway, there is now a single executable name (widtools), and flags are given for various options, sort of like Tcl/Tk. Executing widtools without any arguments will print a help screen, so you don't have to remember the calling sequences. In general, you execute widtools -tag -flag value where tag is one of the words in the list above. You can set many global flag options, such as foreground and background colors, font size and style, etc., by adding additional flags. For example, to show a dialog box with a white background and red text widtools -dialog -fore red -back white Execute widtools without any arguments to view a summary of supported options, and available colors and fonts (colors and fonts are all those supported by xforms v0.84). In a shell script, you execute the widtools command with the $() construct (or the `` construct). The return value depends on the type of widget. For dialog widgets, 0 is returned if "Ok" is selected, 1 if "Cancel is selected. Run the sample script example, and then look at the file to see how I invoked the different widtools. INSTALLATION 0. You must have the XForms library installed (minimum version 0.81) 1. Examine the Makefile to ensure that the system will find the forms library and the X libraries. Then execute make, like this: $make 2. Copy widtools to your binary directory (e.g., /usr/local/bin). LEGAL Permission to use, copy, modify, and distribute this software for any purpose and without fee is hereby granted, provided that the author's name and this notice appear in all copies and in supporting documentation. The author's name shall not be otherwise used publicity pertaining to distribution of the software without specific, written prior permission. THE SOFTWARE IS PROVIDED TO YOU "AS-IS", AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR BE LIABLE TO YOU OR ANYONE ELSE FOR ANY DIRECT, SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER, INCLUDING WITHOUT LIMITATION, LOSS OF PROFIT, LOSS OF USE, SAVINGS OR REVENUE, OR THE CLAIMS OF THIRD PARTIES, WHETHER OR NOT THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH LOSS, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE POSSESSION, USE OR PERFORMANCE OF THIS SOFTWARE. This software is in no way affiliated with the University of Alabama, or NASA and the US government.
