home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / desqview / cntdwn.arc / CNTDWN.DOC < prev   
Text File  |  1989-05-07  |  3KB  |  80 lines
  1.                   CNTDWN Program Documentation, May, 1989
  2.  
  3.  
  4. CNTDWN is Copyright 1989 Kenneth Kletzien.
  5.  
  6. CNTDWN is a DESQview-specific program that will simply count down
  7. the amount of time specified and then exit.  On exit, it will sound a short
  8. "alarm."  Since DESQview API calls are used, it will run in the background
  9. without degrading performance significantly.
  10.  
  11. USAGE: cntdwn [O][Q][E] [[hh:]mm:]ss
  12.  
  13. Q invokes the "quiet" option, disabling the alarm on exit.
  14.  
  15. E invokes the "escape" option, allowing premature exit of the program if
  16. the escape key is pressed (while the window is in the foreground).  Running
  17. with the "E" option will rob more processor time than without.  Without the
  18. "E" option, the only way to terminate the program prematurely is to close its
  19. DESQview window.  The DOS ERRORLEVEL is set to 1 when exit from CNTDWN is 
  20. caused by pressing the escape key.
  21.  
  22. Normally, CNTDWN "wakes up" to update its display once every second. Use of
  23. the "O" option ("Optimized") puts the program to sleep for the entire time
  24. specified, eliminating display updates.
  25.  
  26. If you enter a number greater than 59 for minutes or seconds (mm:ss), 
  27. CNTDWN will accept and count down from that number.  However, both minutes 
  28. and seconds will always "turn over" from 00 to 59.
  29.  
  30.  
  31. Examples: cntdwn 10           counts down 10 seconds and sounds alarm
  32.  
  33.           cntdwn Q 10         counts down 10 seconds and exits (quietly)
  34.  
  35.           cntdwn E 1:30       counts down 1.5 minutes and sounds alarm
  36.                                      (may be interrupted by escape key)
  37.  
  38.           cntdwn 24:00:00     counts down 24 hours and sounds alarm
  39.  
  40.           cntdwn QE 30:00     counts down 30 minutes and exits (quietly)
  41.                                      (may be interrupted by escape key)
  42.  
  43.     batch file to ring alarm continuously after time expired until escape
  44.     is pressed:
  45.  
  46.           cntdwn %1
  47.           :ring
  48.           cntdwn e 0
  49.           IF NOT ERRORLEVEL 1 GOTO :ring
  50.  
  51.  
  52.  
  53. WARRANTY
  54.  
  55. There is no warranty of any kind with CNTDWN and the copyright
  56. holder is not liable for any damages of any kind that
  57. may occur due to use of this software.  By using CNTDWN you agree
  58. to these terms.  If you do not agree to these terms, do not use CNTDWN.
  59.  
  60.  
  61. LICENSE
  62.  
  63. The copyright holder licenses you to copy and distribute CNTDWN.COM and
  64. CNTDWN.DOC for yourself and others for non-commercial purposes, provided 
  65. both files are copied and distributed together.
  66.  
  67. The copyright holder licenses you to use CNTDWN for non-commercial purposes
  68. on a single machine.  License for use for business purposes is granted
  69. upon receipt of $5.00 per copy used or distributed.  Send license fees to:
  70.  
  71.                  Kenneth Kletzien
  72.                  249 West End Avenue
  73.                  New York, NY  10023
  74.  
  75.  
  76. This document Copyright 1989, Kenneth Kletzien.
  77.  
  78.  
  79.  
  80.