home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / KAYPRO / KBSHW321.LBR / KPBISHOW.DQC / KPBISHOW.DOC
Text File  |  2000-06-30  |  4KB  |  72 lines
  1. ;  Kaypro BISHOW v3.1 - buffered bi-directional file scroll utility
  2. ;
  3. ; Version 3.0 and 3.1 mods by Steve Sanders, original program
  4. ; code by Phil Cary (vers 1.0) and in-between versions were
  5. ; modified by many to get it to this present level.
  6. ;
  7. ; This is a complete replacement for TYPE.COM offerring many
  8. ; more advantages such as backward and forward scrolling.
  9. ;
  10. ; KPBISHOW is useable only if you have a video-able Kaypro
  11. ; computer like the New 2, 2X, 2'84, 4'84, 4E, 10, or ROBIE.
  12. ; Older 2s and 4s cannot display inverse video or use the 25th
  13. ; status line display incorporated in this program.
  14. ;
  15. ; KPBISHOW now handles squeezed files as well as regular ASCII
  16. ; files automatically.
  17. ;
  18. ; KPBISHOW is now completely compatible with standard Wordstar control
  19. ; keys and uses the Kaypro arrow keys for +/- scrolling and right and
  20. ; left margin control
  21. ;
  22. ; BISHOW is a  buffered,  bidirectional  version  of  SHOW.ASM
  23. ; which first appeared in Interface Age, November, 1981.  That
  24. ; program  could  only  scroll  forward  in  a  file, and read
  25. ; sectors from disk one at a time as they  were  sent  to  the
  26. ; console.   I  used SHOW frequently to take a quick look at a
  27. ; file without loading a  big  text  editor,  and  to  examine
  28. ; another  file  with the RUN command while in Wordstar.  TYPE
  29. ; does not work since it is not a file that Wordstar can  load
  30. ; and run.
  31. ;
  32. ; It was annoying when I went past the point I was looking for
  33. ; in a file with SHOW, and could not go backwards.  Thus, this
  34. ; bidirectional  version  which  uses  random access reads. In
  35. ; addition, buffering was added so that  the  number  of  disk
  36. ; reads  would  be  reduced,  and  moving  back and forth in a
  37. ; moderate sized file would be speeded up.  There is  a  trade
  38. ; off between the size of the buffer and the length of time it
  39. ; takes to refill the buffer which should be set to the user's
  40. ; preference.
  41. ;
  42. ; There are several customizing items in this program.  One is 
  43. ; the equate "maxsec" which sets the buffer size.   Another is 
  44. ; the  string  in the subroutine "clrscr" just after  the  org 
  45. ; statement.   This should be changed to erase the screen  and 
  46. ; home  the cursor for the user's terminal.   The program,  as 
  47. ; written,  requires a terminal with an erase screen and  home 
  48. ; cursor  function.   Some  terminals  do not allow  the  80th 
  49. ; column  to be filled without going to the  next  line.   For 
  50. ; this reason, the screen width ("maxchr") initially is set to 
  51. ; 79.   The screen sizes can be changed using the "S" (screen) 
  52. ; command.  The parameters that can be changed are the maximum 
  53. ; column  displayed ("maxchr"),  the minimum column  displayed 
  54. ; (allowing  you  to "window" the output),  and the number  of 
  55. ; lines ("scroln").   A zero for the maximum column  displayed 
  56. ; will  give and unlimited screen width.   The maximum  column 
  57. ; displayed  and  the number of lines can be set when  calling 
  58. ; BISHOW,  e.g.,  "BISHOW file.nam 79 24" will give 79 columns 
  59. ; and 24 lines,  and "BISHOW file.nam 79" will give 79 columns 
  60. ; with the default number of lines.  The last customizing item 
  61. ; is the "short" equate.   If this is chosen, the multiplicity 
  62. ; of command forms is not allowed (see the beginning to change 
  63. ; the  commands  used),  and certain messages  are  shortened.  
  64. ; This will allow BISHOW to fit into a 1K area.  If "short" is 
  65. ; false, the program is slightly over 1K.  Finally, direct I/O 
  66. ; to the console is used to avoid echoing the commands to  the 
  67. ; console as the CP/M write console function does.
  68. ;
  69. ; Just  a  small contribution to the public domain software as
  70. ; partial payment for the many fine and  educational  programs
  71. ; the system has given me.  Phil Cary.
  72.