home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d0xx / d090 / printext.lha / PrinText / PrinText.doc < prev    next >
Encoding:
Text File  |  1987-07-26  |  6.9 KB  |  189 lines
  1.                  PRINTEXT v1.2  Documentation      by Opher Dan Kahane
  2. ----------------------------------------------------------------------------
  3.                                                                 04-28-87
  4.  
  5.  
  6. -----------------
  7. What is PrinText?
  8. -----------------
  9.  
  10.  PrinText is a program to display ASCII text files on the screen. Instead of
  11. using the 'type' command in the CLI for reading text files, you can use
  12. PrinText. PrinText includes scrollbar and arrow gadgets, automatic word-wrap,
  13. a search function, speech, IFF picture loading, and online help.
  14.  
  15. IT IS RECOMENDED THAT YOU USE PrinText WITH Kickstart 1.2 AND Workbench 1.2!
  16.  
  17.  PrinText is not a public domain program, it is a Shareware program. This
  18. means that you can copy it to your friends, and if you find it useful please
  19. send me a donation. With your support I will write more Shareware and public
  20. domain programs.
  21. For donations over $10 I'll send back a disk with the latest versions of 
  22. Printext (This is the second version) and Short Cut!, a utility that adds 
  23. menus, macros and shurt-cuts to the CLI. I'll also include the full 
  24. documentation.
  25.  
  26.  
  27. Thanks, and enjoy the program!
  28.  
  29.  
  30.  My address is :
  31.                          Opher D. Kahane
  32.                          3832 Howard ave. #1
  33.                          Los Alamitos, CA 90720
  34.  
  35. Suggestions, questions and bug reports are welcome. For a reply please
  36. include a SASE.
  37.  
  38.  
  39. ---------------------------
  40. Using Printext from the CLI
  41. ---------------------------
  42.  
  43.  The CLI syntax for PrinText is "PrinText [<filename>]". This means that you
  44. can load PrinText by typing "PrinText" , or by typing 'PrinText' followed
  45. by a filename. For example, typing "PrinText myfile.txt" will load PrinText,
  46. and display the text file "myfile.txt".
  47.  
  48.  If you do not supply a filename, a file requester will appear as soon as
  49. PrinText is loaded. You can type in the name of the file you want to read,
  50. then click on the OK gadget to load the file. You can also click on any of the
  51. files which appear in the directory. If you want to change the current 
  52. directory, just type in in the drawer gadget, or click on any of the 
  53. "device" gadgets - df0:, df1:, ram:, and dh0: (for a hard drive).
  54.  
  55. -----------------------------
  56. Using PrinText from Workbench
  57. -----------------------------
  58.  
  59.  To load PrinText from Workbench, double click on the PrinText icon. When
  60. PrinText loads, a requester will appear. Type in the name of the file you
  61. want to load, then click on the LOAD gadget. Clicking on the QUIT gadget
  62. will exit the program without loading the file.
  63.  
  64.  If the text file you want to read has an icon, you can click once on its
  65. icon, press the SHIFT key on the keyboard, and while holding it down, double
  66. click on the PrinText icon. This will load PrinText, and PrinText will load
  67. the text file automatically.
  68.  
  69.  If the default tool of the text file you want to load is set to PrinText,
  70. you can  double click on the icon of the text file, and this will load
  71. PrinText and the text file automatically.
  72. To set a file's default tool to PrinText, do the following:
  73.  
  74. a. Click once on the icon of the text file.
  75. b. Choose INFO from the Workbench menu. This will display the icon's data on
  76. the screen.
  77. c. Click in the 'Default tool' text gadget, and type in "PrinText".
  78. d. Click on the SAVE gadget, and that's all!
  79.  
  80.  
  81.  
  82.  
  83. -------------------------
  84. Using the SEARCH function
  85. -------------------------
  86.  
  87.  Double clicking the RIGHT mouse button will cause the Search requester to
  88. appear. Click inside the text gadget, and type in the word you want to find
  89. (It can also be a phrase or a sentence). You can also choose 'Search' from
  90. Project menu.
  91.  
  92.  To start the search, just click on the SEARCH gadget. When an occurrence of
  93. the word is found, it will be highlighted in red. A requester will appear,
  94. asking if you want to go on with the search or stop it. Click on the CANCEL
  95. gadget to stop the search.
  96.  
  97.  PrinText will search for the given phrase from the first line displayed on
  98. the screen to the end of the file. This means that if the last page is
  99. displayed, the phrase will be searched for only in that page. If the top of
  100. the file is displayed, the whole file will be searched.
  101.  
  102.  If the word is not found, a requester will appear. Click on the 'GO ON'
  103. gadget to continue.
  104.  
  105.  There are two search modes, Simple and Smart. To toggle the mode, click on
  106. the gadget between the SEARCH and CANCEL gadgets.
  107.  
  108.  In the SIMPLE search mode, PrinText will look for the word EXACTLY as you
  109. typed it in. If you type in the word 'Amiga', PrinText will not consider the
  110. words 'amiga' , 'AMIGA' or 'AmIgA' equal to it.
  111.  
  112.  In the SMART search mode, PrinText will look for words that spell the same
  113. as the word you typed in, even if the case of the word is different. So if
  114. you type in the word 'ATARI' (please don't do that) , PrinText will consider
  115. 'atari', 'AtarI' and 'Atari' equal to it.
  116.  
  117.  
  118. ----------------------
  119. Loading an IFF picture
  120. ----------------------
  121.  
  122.  To load an IFF picture (any DPaint, Aegis Images, Graphicraft or Digiview
  123. picture), choose 'Load IFF' from the Project menu or press Right-Amiga I.
  124. A file requester will appear: Click inside the text gadget and type in the
  125. filename, then click on the OK gadget. You can also click on any of the files
  126. in the directory. 
  127. PrinText will load the picture and display it. To go back to PrinText click the 
  128. RIGHT mouse button.
  129. PrinText supports all of the graphics modes of the amiga including HAM (with
  130. up to 4096 colors on the screen) and Interlace.
  131.  
  132.  
  133. ------
  134. Speech
  135. ------
  136.  
  137.  PrinText can read you the whole text file at once or one page at a time.
  138. Choose 'Read all' from the project menu to activate the speech. PrinText
  139. will scroll the text so that the line being read is always the first line on
  140. the screen. The scrolling will stop at the last page.
  141.  
  142.  To read the current page only, click on the "lips" gadget. This time the
  143. screen will not be scrolled.
  144.  
  145.  To stop the reading, click on the "lips" gadget, located to the left of the
  146. depth arrangement gadgets. The reading will stop as soon as the end of the
  147. line being read is reached.
  148.  
  149.  
  150. ------------------------
  151. Command and menu summary
  152. ------------------------
  153.  
  154.  Here is the summary of the menu options, and the command keys.
  155. The letter before the menu option is the command key. To use it instead of
  156. using the mouse, press Right-Amiga and the command key together.
  157.  
  158. Project menu:
  159. ------------
  160.  
  161. A, About - Display help page.
  162. L, Load -  Load a text file.
  163. R, Read all - Read the text file.
  164. S, Search - Search for a word.
  165. I, Load IFF - Load an IFF picture file.
  166. Q, Quit - Exit the program. You can click on the close gadget instead.
  167.  
  168.  
  169. Colors menu:
  170. -----------
  171.  
  172.  Here you can choose the color of the text and the background.
  173.  
  174.  
  175. Movement menu:
  176. ------------
  177.  
  178. T, Goto top - Display the first screen of the file.
  179. B, Goto buttom - Display the last screen of the file.
  180. U, Page UP -  Display previous screen.
  181. D, Page DOWN - Display next screen.
  182. Z, Line UP - Move up one line.
  183. X, Line DOWN - Move down one line.
  184.  
  185.  If you hold down the Right-Amiga Z or Right-Amiga X, PrinText will quickly
  186. scroll through the file.
  187.  
  188.                      
  189.