xwChoice:
---------

XwChoice is a little help programm for the installation of the
XW_TOOLS.

Syntax:
-------
   xwChoice [-title titelString] -message okButtonText messageFile \
            [-geometry geometry]


   xwChoice [-title titelString] -error   okButtonText errorFile
   
   
   xwChoice [-title titelString]                     \
            [-geometry geometry]                     \
            -question questionString                 \
            -choice choice1 answer1                  \
            -choice choice2 answer2                  \
            ...                                      \
            -choice choiceN answerN                  \
            [-help   helpButtonText helpFile]        \
            [-cancel cancelButtonText cancelAnswer]  \
            [-noReturn]                              \
            -ok     okButtonText
            
answerN  = "" -> on OK return choiceN
answerN <> "" -> on OK return answerN
If the -noReturn option is set no item must be selected. If this
option is not set an item must be selected in order to return.
Normally xwChoice return the choice on standard output.

the message or error file may also be a string instaead of a file.
xwChoice look first if ther is a file as passed by the message/error-File
argument and if such a file is not found the argument will be taken
as the message which is to be displayed.

if the cancel button is pressed xwChoice print the cancelASnswer
if the argument ist not a zero length string. Further more
xwChoice exit with the return code 3


   xwChoice [-title titelString]                     \
            [-geometry geometry]                     \
            -question questionString                 \
            -input                                   \
            [-help   helpButtonText helpFile]        \
            [-cancel cancelButtonText cancelAnswer]  \
            -ok     okButtonText

The value entered into the input field is returned, white space at
the beginning of string are deleted. a valid input (non white space
string) is required


   xwChoice [-title titelString]                     \
            [-geometry geometry]                     \
            -question questionString                 \
            -choice choice1 answer1                  \
            -choice choice2 answer2                  \
            ...                                      \
            -choice choiceN answerN                  \
            -input                                   \
            -both                                    \
            [-help   helpButtonText helpFile]        \
            [-cancel cancelButtonText cancelAnswer]  \
            -ok     okButtonText

The user can perform a choice or enter a value.
xwChoice return the value contained in the input field if any or
the selected item.
if the option both is given the item selected and then the value of the
input field are returned.

The help file may also be replaced by a message to be displayed.

   xwChoice [-title titelString]                     \
             -wait OkButtonString "waitFile"

The wait file may also be replaced by a message to be displayed.

xwChoice will be poped up and if an other instance of xwChoice
is started it will be stopped.


Return value:
- 0 OK
- 1 error (OS)
- 2 wrong option
- 3 cancel was pressed
