                            RequestString v1.1
                                Adam Dawes
                              22nd June 1995



What is RequestString?
======================

RequestString is a little utility designed to complement the Commodore
utilities, 'RequestChoice' and 'RequestFile', primarily of use in AmigaDos
shell scripts.

The program simply displays a requester containing text of your choice, and
asks the user to enter a string. The string will then be printed to stdout
(so it's very convenient to redirect the output of RequestString to an
environment variable).



Using RequestString
===================

The parameters for RequestString are as follows:

  RequestString <title> <body> [default=] [pubscreen=] [INVISIBLE]

         Title: The name that will be given to the window that opens
                containing the string requester. (Required)
          Body: The text contained within the string requester. (Required)
       Default: If specified, this text is automatically entered within
                the text gadget when the window opens.
     PubScreen: Allows you to specify a public screen for the requester to
                open upon.
     Invisible: If this switch is present, the text displayed within the
                test gadgets is not shown. This is very useful when asking
                a user to enter a password, etc. Be careful when using both
                'Invibisle' and 'Default=' at the same time, as it can be
                very confusing if you don't know what's already been
                entered in to the gadget!



Requirements
============

RequestString requires Kickstart 2 or greater, and also the ReqTools
library by Nico Franois.



Legal stuff
===========

RequestString is freeware. It may be distributed however and wherever you
like.

I accept no responsibility for any damage done to your system, directly or
indirectly, as a result of using RequestString. You use the program
entirely at your own risk.



History
=======

  v1.0 (39.0)

        Initial release.

  v1.1 (39.1)

        Added 'Default=' keyword.
        Added 'Invisible' switch.
        Added 'PubScreen=' keyword.
        Reduced executable size by 3k.



Contacting the author
=====================

Please do write to me if you like RequestString or if you have any problems
with it or suggestions for a new version. I can't promise to reply quickly
if you write via snail-mail, but I will always reply to email messages. I
can be contacted at:

  InterNet
     ad32@brighton.ac.uk

  FidoNet
     Adam Dawes@2:441/93.5

  SnailMail
     Adam Dawes
     47 Friar Road
     Brighton
     BN1 6NH
     England
