home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / bam351.zip / SASK.DOC < prev    next >
Text File  |  1993-01-06  |  4KB  |  112 lines
  1. --------------------------------------------------------------------------
  2. Version 1.35                       SupremeAsk                     04/26/92
  3. Copyright (c) 1988-92 by SupremeSoft                   All Rights Reserved
  4. --------------------------------------------------------------------------
  5.  
  6.   SASK is simply a Norton ASK clone. It has one added feature, the
  7. ability to import text files as the prompts. This allows you to display
  8. all those README files, and then request the user if they want to follow
  9. a certain course of action. All you have to do is add the prompt at the
  10. end of the README file.
  11.  
  12.   SASK automatically keeps track of the current display line, thus
  13. allowing you to display files which are more than 24 lines long. SASK
  14. will display "More...Press any key" at the end of each page. Naturally,
  15. if the display doesn't overrun one page, no such prompt is made.
  16.  
  17. Calling Syntax:  SASK ["Display Prompt" | filename.txt]  KeyList [/D /K /B]
  18.  
  19.   You have the option to output a standard prompt, just as in Norton's
  20. ASK. To do so, just enclose the prompt in double quotes ("). (See note
  21. for C version), the program will then display that prompt and wait for
  22. one of the keys in KeyList to be entered.
  23.  
  24. Returns:        ERRORLEVEL set according to the key pressed, and it's
  25.                   location in the KeyList
  26.  
  27.                 ERRORLEVEL set to 99 on any Errors including
  28.                 Ctrl-C/Ctrl-Break.
  29.  
  30. Optional
  31. Switches:   /D   Tells SupremeAsk to echo the key that was pressed
  32.             /K   Tells SupremeAsk to suppress the keyboard buffer flush
  33.             /B   Tells SupremeAsk to beep at an invalid key
  34.  
  35.  
  36. The /K switch will come in handy should you want to allow the user to
  37. answer a certain prompt by typing "ahead" of that actual display.
  38.  
  39. The /B switch is provided for users who wish to have the program emit an
  40. audible error beep upon entry of an invalid key.
  41.  
  42. Examples:   SASK "Continue? (Y/N)" yn
  43.  
  44.       Displays <Continue? (Y/N)> and waits for either <Y>, <y>, <N>, <n>
  45. to be pressed. ERRORLEVEL is set as follows:
  46.  
  47.              <Y>,<y>      ERRORLEVEL=1
  48.              <N>,<n>      ERRORLEVEL=2
  49.              Any error    ERRORLEVEL=99
  50.  
  51.  
  52.             SASK readme.txt nye
  53.  
  54.       Displays the file README.TXT and waits for <Y>, <y>, <N>, <n>,
  55. <E>, <e>. ERRORLEVEL is returned as follows:
  56.  
  57.              <N>,<n>      ERRORLEVEL=1
  58.              <Y>,<y>      ERRORLEVEL=2
  59.              <E>,<e>      ERRORLEVEL=3
  60.              Any error    ERRORLEVEL=99
  61.  
  62.  
  63.  
  64. Note 1:  To test ERRORLEVEL in batch files, make sure that you test for
  65. the HIGHEST possible return value FIRST! Otherwise, the batch file will
  66. execute the very first condition. Therefore use the following
  67. construct:  
  68.  
  69.            if ERRORLEVEL=99
  70.            if ERRORLEVEL=98
  71.            if ERRORLEVEL=97
  72.                   .
  73.                   .
  74.                   .
  75.            if ERRORLEVEL=1
  76.  
  77.  
  78. Check your DOS manual for further information.
  79.  
  80. ---------------------------------------------------------------------------
  81. Changes since version 1.31:
  82.  
  83. There was only one small error in the program, thus the reason for not 
  84. updating it for over two years. When you typed SASK by itself to get the 
  85. calling syntax, the program told you that ERRORLEVEL was set from the KeyList 
  86. from right to left. This was WRONG. It is actually from left to right.
  87.  
  88. Changes since version 1.32:
  89.  
  90. Addition of /K, /D and /B command line switches.
  91. ---------------------------------------------------------------------------
  92. License/Warranty:
  93.  
  94.      There is NO warranty either expressed or implied. You use this
  95. program at your own risk! You may NOT hold SupremeSoft accountable for
  96. any damages that may occur either directly or indirectly from the use of
  97. this program.
  98.  
  99.      This program is distributed either by itself, or in a package of 
  100. Utilities. To register SupremeAsk and to get a copy of the latest version,
  101. send $10.00 to the address below:
  102.  
  103.                            SupremeSoft
  104.                            105 Deerfield Drive
  105.                            Easton, CT 06612-1106
  106.  
  107.  
  108. Corporate/Academic site licenses are available.
  109. ---------------------------------------------------------------------------
  110. ASK  is a Registered trademark of norton computing.
  111. ---------------------------------------------------------------------------
  112.