home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / sysutl / comment2.arc / COMMENT.DOC < prev    next >
Text File  |  1986-11-09  |  3KB  |  63 lines
  1.                        DOCUMENTATION FOR COMMENT.SYS
  2.                                 05/19/85
  3.  
  4. COMMENT.SYS is an MSDOS 2.0(+) device driver whose function is simply to
  5. echo a string to the standard output device.  The driver code is not actually
  6. installed by dos, so no memory is wasted, and the driver can be referenced
  7. in CONFIG.SYS as often as desired.
  8.  
  9. COMMENT.SYS is invoked by including a line like the following in your
  10. CONFIG.SYS file:
  11.  
  12. DEVICE=COMMENT.SYS T\his is a \COMMENT.SYS \comment using '\\' escapes.
  13.  
  14. Since DOS converts all characters on the CONFIG.SYS line to upper-case,
  15. it's necessary to use a special 'escape' character to preserve lower-case
  16. input, and the backslash ('\') character was chosen for this purpose.
  17. When COMMENT.SYS sees a single backslash character, it starts converting
  18. characters to lower-case; the conversion continues until another single
  19. backslash character is encountered.  To make an actual '\' character appear
  20. in the output without toggling the lower-case conversion, just use two
  21. backslash characters together ('\\').
  22.  
  23. As an illustration, the CONFIG.SYS line above would be echoed as follows:
  24.  
  25. This is a COMMENT.SYS comment using '\' escapes.
  26.  
  27. The maximum length of the input string is 255 characters.  The count starts
  28. immediately after the 'DEVICE=' string, and includes '\' escape characters,
  29. so the actual maximum length of the echoed string will be somewhat shorter.
  30.  
  31. ------------------------------------------------------------------------------
  32.  
  33. COMMENT.SYS can be used to send ANSI graphics commands to the console
  34. (assuming, of course, that ANSI.SYS has been installed by a previous
  35. CONFIG.SYS line).  The following line, for instance (adapted from an example
  36. in the DOS 3.0 Technical Reference Manual), would reassign the F10 key to a
  37. DIR command followed by a carriage return:
  38.  
  39. DEVICE=COMMENT.SYS <ESC>[0;68;"DIR";13\p
  40.  
  41. The '<ESC>' refers to an ASCII 'ESC' character (27 decimal, 1B hex), which
  42. can be entered using many text editors.  The '\' preceding the 'p' is
  43. necessary since the 'p' must remain in lower-case for the command to
  44. work.
  45.  
  46. I'll leave other potential uses for COMMENT.SYS to your imagination.
  47.  
  48. ------------------------------------------------------------------------------
  49.  
  50. COMMENT.SYS has been tested under PC-DOS 2.0, 2.1, and 3.0.  It seems free
  51. of bugs or side-effects, but while I would like to be informed of any problems
  52. you may encounter, I can't be responsible for any possible damage and/or
  53. loss of data that may result from the use of COMMENT.SYS.
  54.  
  55. The program was written at the suggestion of Walter Kennamer (CompuServe
  56. 74025,514).
  57.  
  58. Skip Gilbrech
  59. 90 Lexington Ave. #10-G
  60. New York, NY 10016
  61. CompuServe 71445,534
  62. (please leave messages on PCS-131)
  63.