home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast.iso / screen / savscr.doc < prev    next >
Text File  |  1994-03-07  |  4KB  |  75 lines
  1.  
  2.                        SAVSCR.COM - A Documentation Aid
  3.                        --------------------------------
  4.  
  5.  
  6. A  common documentation task is to describe the appearance of  the  computer's
  7. display  screen as it appears in the midst of running a program.   SAVSCR is a
  8. utility  that makes that job easy by saving any text-mode display screen in  a
  9. disk file when the Shift-PrtSc keys are pressed at the same time. An editor or
  10. word  processing program may be used to incorporate the saved screen  image(s)
  11. into your documentation,  or the screen image(s) could be sent to a printer at
  12. a later time (which means that you can make slides for an overhead  projector,
  13. even on a PC which doesn't have a printer directly attached to it).
  14.  
  15. SAVSCR is started by typing
  16.  
  17.      SAVSCR [[d:]\path\]filename.ext
  18.  
  19. to the PC/MS-DOS command line interpreter (COMMAND.COM).   As  indicated,  the
  20. disk device and the pathname specifications are optional,  however SAVSCR will
  21. automatically default them to the current disk and current directory if you do
  22. not specify them.
  23.  
  24. The  first time that SAVSCR is invoked it will make itself resident in  memory
  25. and, if the specified output file does not already exist, will create an empty
  26. file  by that name.   Thereafter,  SAVSCR "traps" the PrtSc interrupts (IBM PC
  27. BIOS interrupt 5),  and each time Shift-PrtSc is pressed the text contents  of
  28. the display screen will be appended to the specified output file (each display
  29. screen  image  is  separated  from  previous  screen  images  by  a  form-feed
  30. character).
  31.  
  32. It  is not possible to remove memory resident programs such as SAVSCR  without
  33. rebooting PC/MS-DOS, but if SAVSCR is run after it is installed, then you will
  34. have  the  opportunity  to make it inactive and restore the  normal  PC/MS-DOS
  35. function  of  the  PrtSc key (i.e.,  the screen image is sent  directly  to  a
  36. printer),  and you will also have the opportunity to request instructions  for
  37. running SAVSCR.
  38.  
  39. SAVSCR  is  quite  different from the public domain program on  which  it  was
  40. based,   SAVSC.COM.   SAVSCR   uses  DOS V2.0  features  to  support  a   path
  41. specification  in a filename,   works correctly with any of the eight  display
  42. pages  allowed on IBM graphics adapters (Color Graphics Adapter,  Professional
  43. Graphics Adapter, and the Enhanced Graphics Adapter), dynamically supports the
  44. Enhanced  Graphics  Adapter  in 43-line  mode  or  25-line  mode,  dynamically
  45. supports  40- and  80-column video modes,  and has changed the activation  key
  46. sequence from Shift-Scroll Lock-PrtSc to Shift-PrtSc because some  third-party
  47. keyboards  will  not  transmit the former key sequence and it  could  also  be
  48. difficult  for  certain handicapped people to enter a 3-keystroke sequence  at
  49. once (software developers should be careful about that sort of thing...).
  50.  
  51. The full assembly source code,  SAVSCR.ASM, has also been placed in the public
  52. domain.  It is unfortunate that so many public domain utilities do not include
  53. source code;  we can all learn from useful programs,  and including the source
  54. code also allows people to improve or customize programs for their own use.
  55.  
  56.  
  57.         -------------------------------------------------------------
  58.  
  59.                V1.1 12/31/85 - Vince Cuomo, Chino Hills CA
  60.                V1.0 09/27/85 - Ted Shapin, Orange CA
  61.                              - And,  of course, thanks to the unknown
  62.                                author   of  the  original   SAVSC.COM
  63.                                program.
  64.  
  65.         Note:  If  anyone makes changes to SAVSCR and would  like  to
  66.                place  them  in the public domain,  or if  anyone  has
  67.                suggestions  or comments concerning SAVSCR,  then  the
  68.                above-named  authors  may be contacted by  writing  to
  69.                them at the following address:
  70.  
  71.                          c/o North American Software, Inc.
  72.                              P.O. Box 3309
  73.                              Tustin, CA  92680
  74.  
  75.