home *** CD-ROM | disk | FTP | other *** search
/ Amiga Times / AmigaTimes.iso / spiele / Labyrinth / requeststring / RequestString.readme < prev    next >
Encoding:
Text File  |  1998-10-06  |  3.1 KB  |  91 lines
  1. RequestString                                                   RequestString
  2.  
  3.    NAME
  4.     RequestString
  5.  
  6.    VERSION
  7.     RequestString 39.0 by Thomas Kessler (12.08.94)
  8.  
  9.    DISCLAIMER
  10.     RequestString ©1994-96 Thomas Kessler (kessler@fen.baynet.de)
  11.     All rights reserved.
  12.  
  13.     RequestString uses 'reqtools.library' V38+
  14.     ©1991-1994 Nico François, ©1995-1996 Magnus Holmgren
  15.     available on aminet: util/libs/ReqToolUsr.lha
  16.  
  17.     This software is EMAILWARE (Freeware).
  18.     Please send me a small email if you like and use this program.
  19.  
  20.     This software is provided as-is, without warranty of any kind,
  21.     either expressed or implied. In no event will the author be liable
  22.     for direct, indirect, incidental or consequential damages or data
  23.     loss resulting from the use or application of this software. The
  24.     entire risk as to the results and performance of this software is
  25.     assumed by the user.
  26.  
  27.    FUNCTION
  28.     RequestString is very similar to RequestChoice and RequestFile
  29.     which are included in the Workbench 3.x release.
  30.  
  31.     It allows the user to enter some text which is then printed to
  32.     StdOut. You can redirect that output to whereever you want,
  33.     e.g. to an environment variable or to any other file.
  34.  
  35.     It is 'pure' so it can be made resident.
  36.  
  37.    SYNOPSIS
  38.     RequestString TITLE/A,BODY/A,STRING/K,PUBSCREEN/K,NOLINE/S,
  39.                    NOQUOTE/S,NOEMPTY/S,PASSWORD/S,REQPOS/K
  40.  
  41.     TITLE (required)   titletext of requester
  42.  
  43.     BODY (req.)        text in the requester to explain to the user
  44.                        what to do... more textlines can be realized
  45.                        by using '*N' for a linebreak
  46.  
  47.     STRING (optional)  given text which can be changed by the user
  48.                        default: empty
  49.  
  50.     PUBSCREEN (opt.)   name od a public screen to open the requester on
  51.                        default: Workbench
  52.  
  53.     NOLINE (opt.)      no linebreak after text at output to StdOut
  54.                        default: linebreak
  55.  
  56.     NOQUOTE (opt.)     no quotes around text at output to StdOut
  57.                        default: text returned in "quotes"
  58.  
  59.     NOEMPTY (opt.)     if no string is entered RequestString returns with
  60.                        returncode WARN instead printing an empty string
  61.                        default: empty string is valid
  62.  
  63.     PASSWORD (opt.)    entered text is invisible, but output to StdOut
  64.                        is of course VISIBLE!
  65.                        default: visible
  66.  
  67.     REQPOS (opt.)      override the default-prefs of ReqTools
  68.                        REQPOS=CENTER centers the requester on screen
  69.                        REQPOS=POINTER opens the requester near to pointer
  70.                        default: ReqTools-Prefs
  71.  
  72.    EXAMPLE
  73.     RequestString "Titletext" "Please enter*Nsomething:" REQPOS=POINTER
  74.  
  75.    HISTORY
  76.     1.0 (12.08.94)   first public release
  77.                      (to Aminet in 12/96)
  78.  
  79.    DISTRIBUTION
  80.     Distribution on Aminet and AminetCDs is allowed.
  81.     Distribution by Fred Fish is allowed.
  82.     Distribution on MeetingPearlsCDs is allowed.
  83.  
  84.     You are allowed to include RequestString in your own projects as
  85.     long as they are Freeware. This RequestString.readme MUST also
  86.     be included!
  87.  
  88.     Other distribution without written permission of the author is
  89.     strictly forbidden (contact me via email).
  90.  
  91.