home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / EDITORS / EZREAD19.ZIP / EZREAD19.DOC < prev    next >
Text File  |  1992-08-19  |  9KB  |  155 lines
  1.                                EZREAD VERSION 1.9
  2.                       (c) Copyright  David Batchelor  1992
  3.                               All Rights Reserved
  4.  
  5.  
  6. System requirements: Any IBM PC compatible running DOS 2.0 or higher.
  7.                      EGA or VGA color monitor, ANSI.SYS or equivalent.
  8.  
  9. EZREAD is a replacement for the DOS TYPE command for reading a text file on the
  10. PC screen.  The DOS TYPE command operates too fast for comfortable reading.
  11. EZREAD presents text at a rate slow enough to read -- a rate chosen by the user
  12. -- for the convenience of a user who simply wants to read a scrolling file at a
  13. relaxed pace, "no hands," without having to type a carriage return repeatedly
  14. (as the DOS TYPE | MORE command requires).  EZREAD enables the user to change
  15. the scroll speed while reading, to skip ahead or back (impossible for the TYPE
  16. command), and more.  EZREAD prints blank lines without delay to save time.  It
  17. also lets you search for text keywords in text files.  Text is in easy-to-read
  18. black letters on a white background.  No other PC utility has all of these
  19. features.
  20.  
  21.  
  22.                                  USING EZREAD
  23.  
  24. The command line format is
  25.  
  26.         EZR input_file_name -d# -w
  27.  
  28. where # represents a character from the following list: 0, q, h, 1, 2, 3, 4, 5,
  29. 6, 7, 8, or 9, the desired number of seconds between typed lines (q gives you
  30. 1/4 second and h gives you 1/2).  The "input_file_name" parameter is optional,
  31. and the program will prompt the user if it is not present.  The "-d#" parameter
  32. is also optional, and if it is absent, the default interline delay of 3 seconds
  33. is assumed.  I have found that this is a good match to users' reading rates.
  34. (It is simple to invoke EZREAD with a BAT file if you would rather use another
  35. delay.  Just put EZR %1 -d4 into a BAT file, and use the BAT file and the
  36. input_file_name.)  The optional -w switch turns off character wrapping onto the
  37. next line; if your screen has 80 columns but the lines are longer, you might
  38. want this option.
  39.  
  40. Several commands are valid during scrolling:
  41.         h or H  for Help (a command list will appear)
  42.         q or Q  to Quit (the Esc key also works)
  43.         f or F  to go Faster (decrease the interline delay in steps)
  44.         s or S  to go Slower (increase the interline delay in steps)
  45.         PgDn    to view the next 24 lines immediately
  46.         PgUp    to view the preceding 24 lines immediately
  47.         w or W  to Wait until you press another key
  48.         l or L  to display the current Line number in the file
  49.         g or G  to Go directly to another line number in the file
  50.         b or B  to Begin scrolling again at your chosen starting line number
  51.         ?       to search for a keyword (character string) of your choice
  52.  
  53. Also, if you want to see the next line without delay, you can hit a carriage
  54. return to get it.
  55.  
  56. EZREAD allows you to search for a character string of as many as 32 characters.
  57. The search starts on the next line (not typed yet on the screen).  If the
  58. character string is found, EZREAD skips ahead to the first line containing it
  59. and starts typing with that line.  The string you found is highlighted.  If the
  60. character string is not found in the file -- between the bottom line you see and
  61. the end of file -- then your place in the file does not change.  The search for
  62. characters does not distinguish upper and lower case letters (for example, if
  63. you searched for ezread you would also find EZREAD and vice versa).
  64.  
  65. When the end of the file is reached, EZREAD types a message giving the line
  66. number of the last line and the file name, and quits.
  67.  
  68. EZREAD can handle text files with lines that are longer than 80 characters.  If
  69. your PC is in 132-column mode, you can view files containing 132-character lines
  70. using EZREAD.  You should use the -w switch to avoid unnecessary line feeds
  71. when a line has 132 characters.
  72.  
  73. EZREAD provides a filter to screen out control characters in files (ASCII
  74. characters 0 through 31, except ^I, the tab character).  These characters are
  75. displayed in reverse video, using the corresponding printable character, e.g.
  76. ^L (form feed) is displayed as a letter L on a blue background.  This is useful
  77. for examining files created by some word processors, which use control
  78. characters as code for Italics or other functions.  A ^Z in a text file will be
  79. treated by EZREAD as the End of File, however, and not be printed.  Tabs (ASCII
  80. code 9) are expanded as 8 blanks, rather than the symbol ^I.
  81.  
  82.  
  83.                                LICENSE AGREEMENT
  84.  
  85. This program is SHAREWARE.  You are granted a reasonable try-out period of 30
  86. days in which you may test EZREAD to see if it serves your needs.  By trying
  87. EZREAD, you implicitly agree to these terms.  If you use EZREAD beyond 30 days
  88. after first trying it out, then you are required to send the license fee of
  89. $2.00 US to the author.  (EZREAD is the copyrighted property of the author, and
  90. you are granted the right to use it under the conditions in this paragraph.)
  91. The license fee entitles you to unlimited registered use of future releases of
  92. EZREAD, to gab about the program or things in general with the author, and you
  93. will receive a copy of the program source code in C upon request.  You are free
  94. to copy and distribute EZREAD under the following conditions: the executable
  95. file EZR.EXE and this file EZREAD19.DOC are not altered in any way, both files
  96. are included together in any distribution, and no money is received by the
  97. distributor (except perhaps media costs).  This program is offered to you for
  98. personal use only, not for use in a business environment without a business
  99. license agreement.  Please contact the author to arrange a business license
  100. agreement with substantial discounts for multiple copies.  (Exception:  EZREAD
  101. is free of charge, however, to any federal government employees, for personal
  102. or professional uses.)
  103.  
  104. I welcome comments from users and suggestions for new features.  I can be
  105. reached by postal mail at
  106.  
  107.                         David Batchelor
  108.                         11412 Hawk Ridge Court  
  109.                         Beltsville, MD  20705
  110.  
  111. Users are welcome to call me at (301) 937-4796 with questions or comments.  I
  112. also can be contacted via Email on several Washington, DC, area BBSs, such as
  113. the Capital PC Users' Group Member Information Exchange (301)738-9060.
  114.  
  115. I am still developing the program and plan to add a few more features in future
  116. releases.  I would appreciate hearing from you if you encounter any problems or
  117. have comments about EZREAD.  
  118.  
  119. A popular utility for browsing files is LIST.COM by Vernon Buerg, which does
  120. many, many more functions than EZREAD.  LIST.COM has a continuous scrolling
  121. function, but EZREAD can slow down to a much slower pace than LIST and let you
  122. read lots of pages of text without ever touching the keyboard.  LIST also makes
  123. you wait for blank lines to scroll by, unlike EZREAD.  The main advantage of
  124. using EZREAD is the streamlined access it gives you to continuous scrolling of
  125. text with minimum fuss for minimum price.  EZREAD is what the DOS TYPE command
  126. might have been...
  127.  
  128. EZREAD is also helpful to computer users who are visually impaired and have
  129. other software installed which can read aloud what is printed on the screen.  
  130.  
  131. EZREAD returns an error level of 1 if the input file cannot be opened on the
  132. second attempt; otherwise it terminates setting an error level of 0.
  133.  
  134. Release history:
  135.  
  136. SLOWTYPE Version 0.3  Nov. 13, 1990  (prototype with few functions)
  137. SLOWTYPE Version 0.4  Nov. 15, 1990       "      "    "      "
  138. EZREAD Version 1.0    Nov. 20, 1990  (1st full-featured version)
  139. EZREAD Version 1.1    Jan. 17, 1991  (performance tune-up)
  140. EZREAD Version 1.2    Nov.  7, 1991  (ANSI screen control added)
  141. EZREAD Version 1.3    Nov. 14, 1991  (Control character filter added; fixed a
  142.                                       bug: in ver 1.2, line # was 1 too large
  143.                                       on exit at EOF)
  144. EZREAD Version 1.4    Nov. 16, 1991  (Delays of 1/2 and 1/4 second possible)
  145. EZREAD Version 1.5    Nov. 20, 1991  (PgDn and PgUp functions added)
  146. EZREAD Version 1.6    Nov. 21, 1991  (Fixed a bug in runtime command
  147.                                       interpreter)
  148. EZREAD Version 1.7    Nov. 23, 1991  (Added search for character string and
  149.                                       a performance tune-up)
  150. EZREAD Version 1.8    July 12, 1992  (Added EGA/VGA color, fixed a bug or 2)
  151. EZREAD Version 1.9    Aug. 19, 1992  (Removed beep, which hung some 486's
  152.                                       and improved TAB display)
  153.  
  154. I hope you enjoy the program!           - Dave
  155.