home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / BATBOX11.ZIP / BOXES.DOC < prev    next >
Text File  |  1991-07-09  |  3KB  |  68 lines
  1.                                 BOXES.DOC   1.1
  2.  
  3.                               by Mel Raff  7/9/91
  4.  
  5. These are a pair of simple utilities I wrote to make batch files work in a
  6. more presentable fashion.
  7.  
  8. BOXECHO simply displays the content of a text file on the screen in a colored 
  9. box.  The only required parameter is the name of the text file (including its
  10. directory path, if not in the default directory).  You can also specify the
  11. background and foreground colors (default is white on blue), the location of
  12. the top row and left column, and whether or not to pause for a keystroke 
  13. before exiting (or returning to the calling batch file).  
  14.  
  15. For instructions, enter BOXECHO with no parameters at all.  A batch file 
  16. demonstrating the operation of BOXECHO, ECHODEMO.BAT, is included, along
  17. with the text file it displays, ECHO.TXT. 
  18.  
  19. BOXYESNO displays the content of a text file and then waits for the user to
  20. press Y or N.  If the user presses Y, BOXYESNO returns, setting the DOS 
  21. errorlevel to 0.  If the user presses N, BOXYESNO returns with errorlevel set
  22. to 1.  If any key other than Y, y, N, or n is pressed, BOXYESNO beeps and 
  23. continues to wait.  By properly structuring the batch file which calls 
  24. BOXYESNO, you can make a batch file branch according to the user response.  
  25.  
  26. Full instructions appear when BOXYESNO is entered with no parameters.  A batch
  27. file demonstrating the operation of BOXYESNO, YESNO.BAT, is included, along 
  28. with the text file it displays, YESNO.TXT.
  29.  
  30. These programs were written in Turbo C with assembly language routines to
  31. speed screen output.  To afford complete compatibility, I have included
  32. versions of the programs which use the BIOS rather than writing directly
  33. to video memory.  If BOXECHO and BOXYESNO do not perform properly on your
  34. system, try these versions instead.  To do so, delete or rename BOXECHO.COM
  35. and BOXYESNO.COM; then, rename BOXECHOB.COM to BOXECHO.COM and BOXYESNB.COM
  36. to BOXYESNO.COM.  Screen output will be more noticeably line-by-line, but
  37. it should still look good, and the programs should work properly.
  38.  
  39. BATBOX11.ZIP Contents (9 files):
  40.  
  41.    BOXECHO.COM
  42.    BOXYESNO.COM            These are the programs.
  43.  
  44.    BOXECHOB.COM
  45.    BOXYESNB.COM            These are BIOS-compatible versions of the programs.
  46.  
  47.    ECHODEMO.BAT            Demo BAT file for BOXECHO.COM
  48.    ECHO.TXT                Demo text file for ECHODEMO.BAT
  49.  
  50.    YESNO.BAT               Demo BAT file for BOXYESNO.COM
  51.    YESNO.TXT               Demo text file for YESNO.BAT
  52.  
  53.    BOXES.DOC               This file.
  54.  
  55.  
  56. These utilities are hereby released forever into the public domain: they are
  57. freeware.  You are encouraged to distribute these files AS A PACKAGE as widely
  58. as you wish.  You are nevertheless welcome to donate a dollar or two if you 
  59. find them useful and feel so inclined.  Such donations would improve the 
  60. quality of my state of mind, if not my material welfare, and, more to the 
  61. point, they would let me know that the programs are appreciated.  As a result,
  62. I might work to improve them, or even create some more.  But comments and 
  63. suggestions are welcome in any case.
  64.  
  65.                                    Mel Raff
  66.                               7319 Willow Avenue
  67.                             Takoma Park, MD 20912
  68.