home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 123 / af123a.adf / af123a2.lzx / Selector / Tools / docs / RequestString.txt < prev    next >
Encoding:
Text File  |  1999-03-04  |  2.6 KB  |  100 lines
  1.                             RequestString v1.1
  2.                                 Adam Dawes
  3.                               22nd June 1995
  4.  
  5.  
  6.  
  7. What is RequestString?
  8. ======================
  9.  
  10. RequestString is a little utility designed to complement the Commodore
  11. utilities, 'RequestChoice' and 'RequestFile', primarily of use in AmigaDos
  12. shell scripts.
  13.  
  14. The program simply displays a requester containing text of your choice, and
  15. asks the user to enter a string. The string will then be printed to stdout
  16. (so it's very convenient to redirect the output of RequestString to an
  17. environment variable).
  18.  
  19.  
  20.  
  21. Using RequestString
  22. ===================
  23.  
  24. The parameters for RequestString are as follows:
  25.  
  26.   RequestString <title> <body> [default=] [pubscreen=] [INVISIBLE]
  27.  
  28.          Title: The name that will be given to the window that opens
  29.                 containing the string requester. (Required)
  30.           Body: The text contained within the string requester. (Required)
  31.        Default: If specified, this text is automatically entered within
  32.                 the text gadget when the window opens.
  33.      PubScreen: Allows you to specify a public screen for the requester to
  34.                 open upon.
  35.      Invisible: If this switch is present, the text displayed within the
  36.                 test gadgets is not shown. This is very useful when asking
  37.                 a user to enter a password, etc. Be careful when using both
  38.                 'Invibisle' and 'Default=' at the same time, as it can be
  39.                 very confusing if you don't know what's already been
  40.                 entered in to the gadget!
  41.  
  42.  
  43.  
  44. Requirements
  45. ============
  46.  
  47. RequestString requires Kickstart 2 or greater, and also the ReqTools
  48. library by Nico François.
  49.  
  50.  
  51.  
  52. Legal stuff
  53. ===========
  54.  
  55. RequestString is freeware. It may be distributed however and wherever you
  56. like.
  57.  
  58. I accept no responsibility for any damage done to your system, directly or
  59. indirectly, as a result of using RequestString. You use the program
  60. entirely at your own risk.
  61.  
  62.  
  63.  
  64. History
  65. =======
  66.  
  67.   v1.0 (39.0)
  68.  
  69.         Initial release.
  70.  
  71.   v1.1 (39.1)
  72.  
  73.         Added 'Default=' keyword.
  74.         Added 'Invisible' switch.
  75.         Added 'PubScreen=' keyword.
  76.         Reduced executable size by 3k.
  77.  
  78.  
  79.  
  80. Contacting the author
  81. =====================
  82.  
  83. Please do write to me if you like RequestString or if you have any problems
  84. with it or suggestions for a new version. I can't promise to reply quickly
  85. if you write via snail-mail, but I will always reply to email messages. I
  86. can be contacted at:
  87.  
  88.   InterNet
  89.      ad32@brighton.ac.uk
  90.  
  91.   FidoNet
  92.      Adam Dawes@2:441/93.5
  93.  
  94.   SnailMail
  95.      Adam Dawes
  96.      47 Friar Road
  97.      Brighton
  98.      BN1 6NH
  99.      England
  100.