home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / sched120.zip / SASK.DOC < prev    next >
Text File  |  1991-11-15  |  4KB  |  106 lines
  1. -----------------------------------------------------------------------------
  2. Version 1.34                       SupremeAsk                    10/23/90
  3. Copyright (c) 1988-90 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]
  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. Options:   The inclusion of the /D switch causes SASK to display the key that
  31.            was pressed.
  32.  
  33.            The inclusion of the /K switch causes SASK to flush the keyboard
  34.            buffer before obtaining user input. In this way all type ahead is
  35.            removed.
  36.  
  37. Examples:   SASK "Continue? (Y/N)" yn  /D
  38.  
  39.       Displays <Continue? (Y/N)> and waits for either <Y>, <y>, <N>, <n>
  40. to be pressed. ERRORLEVEL is set as follows:
  41.  
  42.              <Y>,<y>      ERRORLEVEL=1
  43.              <N>,<n>      ERRORLEVEL=2
  44.              Any error    ERRORLEVEL=99
  45.  
  46.  
  47.             SASK readme.txt nye
  48.  
  49.       Displays the file README.TXT and waits for <Y>, <y>, <N>, <n>,
  50. <E>, <e>. ERRORLEVEL is returned as follows:
  51.  
  52.              <N>,<n>      ERRORLEVEL=1
  53.              <Y>,<y>      ERRORLEVEL=2
  54.              <E>,<e>      ERRORLEVEL=3
  55.              Any error    ERRORLEVEL=99
  56.  
  57.  
  58.  
  59. Note 1:  To test ERRORLEVEL in batch files, make sure that you test for
  60. the HIGHEST possible return value FIRST! Otherwise, the batch file will
  61. execute the very first condition. Therefore use the following
  62. construct:  
  63.  
  64.            if ERRORLEVEL=99
  65.            if ERRORLEVEL=98
  66.            if ERRORLEVEL=97
  67.                   .
  68.                   .
  69.                   .
  70.            if ERRORLEVEL=1
  71.  
  72.  
  73. Check your DOS manual for further information.
  74.  
  75. Note 2: Unlike Norton ASK, the program does not Beep at an incorrect key
  76. entry. Also, unlike ASK, the program will ALWAYS display it's copyright
  77. notice
  78. ---------------------------------------------------------------------------
  79. Changes since version 1.32:
  80.  
  81. The C versions are no longer distributed.
  82.  
  83. The two switches (/D and /K) have been included to allow the user to be a
  84. little more in control of the program.
  85. ---------------------------------------------------------------------------
  86. License/Warranty:
  87.  
  88.      There is NO warranty either expressed or implied. You use this
  89. program at your own risk! You may NOT hold SupremeSoft accountable for
  90. any damages that may occur either directly or indirectly from the use of
  91. this program.
  92.  
  93.      This program is distributed either by itself, or in a package of 
  94. Utilities. To register SupremeAsk and to get a copy of the latest versions of 
  95. all the Utilities send $10.00 to the address below:
  96.  
  97.                            SupremeSoft
  98.                            105 Deerfield Drive
  99.                            Easton, CT 06612
  100.                            Re: SASK (1.34)
  101.  
  102. Corporate/Academic Site Licenses are available.
  103. ---------------------------------------------------------------------------
  104. ASK  is a Registered Trademark of Norton Computing.
  105. ---------------------------------------------------------------------------
  106.