home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / text / textengi.dms / textengi.adf / TextEngine2.1 / textengine2.1.doc < prev    next >
Text File  |  1992-11-11  |  9KB  |  207 lines

  1.  
  2.          Textengine V2.1 (C) Copyright Nicholas Harvey 1991.
  3.  
  4. This program is public domain shareware, so please register ownership 
  5. by sending ú5 to:
  6.  
  7.         Nicholas Harvey
  8.         149 Manor Road North
  9.         Thames Ditton
  10.         Surrey
  11.         KT7 OBQ
  12.         England
  13.  
  14. I give my permission for this program to be freely distributed only if
  15. the program, this doc file, and all icons are kept together.
  16.  
  17. The story so far...
  18. At the beginning of the 1990 summer holidays, I thought to myself, "I 
  19. need a word processor!" So, after looking through magazine adverts I 
  20. came to the conclusion that I was not going to spend ú100+ on a 
  21. wordprocessing system, so I wrote my own. Ten months of R&D (and 
  22. thousands of problems) produced TEXTENGINE V1.0 - a word processor to 
  23. my own specification written entirely in assembly language. Then, 
  24. after a few additions were made, TEXTENGINE V2.0 emerged. TEXTENGINE 
  25. V2.1 has the addition of a macro feature and improved editing 
  26. facilities. If you use it, please send ú5 (or more) to me at the 
  27. address above.
  28.  
  29.  
  30. VERSION 2 IMPROVEMENTS:
  31.  
  32. -New pull down menu layout.
  33. -Erase file facility.
  34. -Disk DIR facility.
  35. -Line centering function.
  36. -The ability to switch between PAL and NTSC.
  37. -The DELETE key works properly.
  38.  
  39.  
  40. VERSION 2.1 IMPROVEMENTS:
  41.  
  42. -10 macros with a user freindly macro editor.
  43. -The ability to move to the begining/end of a line by using
  44.  SHIFT+left/right cursor keys.
  45.  
  46.  
  47. Loading Textengine from Workbench.
  48. Double click on its icon and the program will load in a few seconds.
  49.  
  50. Loading Textengine from the CLI.
  51. Type RUN TEXTENGINE <filename> where the filename is the name of the 
  52. file you want the program to load automatically when it loads. If you 
  53. don't want to load a file on start up, ignore the <filename> option.
  54.  
  55.  
  56. Instructions.
  57. Control of the cursor and input of text is the same as any text editor
  58. you may have used during your life. There is a text buffer of 50kb, 
  59. which should be large enough for most documents. When the text buffer 
  60. is full, all text input will cease until some text is deleted, or the 
  61. buffer is cleared. You can check if the buffer is full by selecting 
  62. ABOUT from the EXTRAS pull-down menu.
  63.  
  64. The delete key (marked DEL), now deletes the character underneath the 
  65. cursor, and the TAB key produces a space character instead of a tab. 
  66. To move quickly through the file, you can hold SHIFT down while using
  67. the up and down cursor keys. This moves you a page at a time. Holding 
  68. shift down while using the left and right cursor keys moves you to the
  69. beginning and end of a line respectively.
  70.  
  71. The word-wrap works well if used properly. The width of the page is 70
  72. columns with a 5 column margin at either side. The word-wrap activates
  73. when the current line being edited becomes 71 characters long. When 
  74. this happens, the last word in that line is pushed onto the next line.
  75. For this to happen, though, the cursor has to be at the end of the 
  76. line, as if you were typing a line of text from scratch. If you are 
  77. inserting text into the middle of a line, text input will cease when 
  78. the line becomes 70 characters long.
  79.  
  80. To centre the current line, either select CENTRE LINE from the TEXT 
  81. menu, or press CONTROL+C (^C). This automatically centres the line.
  82.  
  83. Disk operations.
  84. Loading and saving files is simplicity in itself. Selecting LOAD or 
  85. SAVE from the DISK pull-down-menu presents you with a string gadget
  86. (where you input the filename) and two other gadgets (LOAD or SAVE, 
  87. and CANCEL). When you have entered the filename, you can either 
  88. load/save the file, or cancel the procedure by selecting the 
  89. appropriate gadgets.
  90.  
  91. New additions to this menu are ERASE and DIR. ERASE is used to delete 
  92. a file from the disk, and DIR is used to view the contents of a 
  93. directory. Both of these are used in much the same way as LOAD and 
  94. SAVE.
  95.  
  96. PRINT, CLEAR, ABOUT, SLEEP, and QUIT are now in the PROJECT menu.
  97.  
  98. PRINT simply prints the file.
  99.  
  100. Selecting CLEAR from the menu will clear the text buffer after 
  101. confirming the operation with a requester.
  102.  
  103. ABOUT displays a little information about the program, and also 
  104. displays the amount of free memory, and the size (in bytes) of the 
  105. current file.
  106.  
  107. Selecting QUIT from the menu will quit the program after confirming 
  108. the operation with a requester.
  109.  
  110. When you chose SLEEP from the menu, the program closes the main 
  111. editing screen and opens a small window on the workbench screen. In 
  112. doing this, the program can multitask more easily, and releases about 
  113. 50kb of memory. To get back to the editor and any text you may have 
  114. been editing, simply click on the CANCEL gadget. This returns you to 
  115. the editor, at the top of the current file.
  116.  
  117.  
  118. Printer styles.
  119. In the STYLES menu, there is a list of many different styles that most
  120. printers can produce. Selecting one of the styles will produce an 
  121. unusual character in the text. Eg  ╦  is the character for PICA text. 
  122. When using these control characters, the first time you use them, the 
  123. effect is turned on, and the next time you select the same style, it 
  124. is turned off. For instance, in the text
  125.  
  126.      Textengine V2.1 - The ¬best¬ wordprocessor for the Amiga.
  127.  
  128.                                          the word "best" is printed 
  129. ENLARGED, whereas the rest of the sentence is normal print. The only 
  130. two control characters which don't work like this are ELITE and PICA. 
  131. These only work as ON switches as they cancel each other when 
  132. selected. For instance, selecting ELITE cancels PICA, and selecting 
  133. PICA cancels ELITE. If you want to cancel all of the styles that have 
  134. been selected, use the CANCEL STYLES character. This resets the 
  135. printer to normal draft mode.
  136.  
  137. My advice to you on using control characters is to type in the entire 
  138. file first, making sure it is correct, and then turn off the word-wrap
  139. and add all of the type styles that you need. Save this off as the 
  140. finished file, and then print it.
  141.  
  142.  
  143. Special tools.
  144. Also In the TEXT menu, a couple useful tools can be found.
  145.  
  146. The first menu item is the WORD WRAP switch. If there is a * symbol 
  147. before the words WORD WRAP, then word wrap is activated. If the * is 
  148. not present, then word wrap is switched off. To change the status of 
  149. the word wrap, hold the mouse pointer over the WORD WRAP menu item, 
  150. and then let go.
  151.  
  152. The second is WORD COUNT which simply counts the number of words and 
  153. lines in the document. To stop counting, click on CANCEL.
  154.  
  155. In the PREFS menu, 4 options are available to set up the wordprocessor
  156. to your own needs. The first item is PRINTER. Here you have 3 inputs. 
  157. TOP MARGIN is the number of lines you want left clear at the top of a 
  158. page. BOTTOM MARGIN is the number of lines you want left at the bottom
  159. of the page. LINES PER PAGE is the maximum number of lines of text you
  160. can fit onto the piece of paper you are using with no gaps at the top 
  161. or bottom. It is very important that you get this value correct.
  162.  
  163. After PRINTER comes PALETTE, which allows you to change the screen 
  164. colours in the usual amiga way. Select the colour you want to change 
  165. by clicking on its box at the top of the palette, and then alter the 
  166. red, green and blue values of that colour using the sliding gadgets.
  167.  
  168. If you use an NTSC computer, you can still use TEXTENGINE. Simply 
  169. select NTSC from the PREFS menu, and the screen will shrink to 200 
  170. lines high.
  171.  
  172. MACROS are defined in the macro editor. There are 10 string gadgets, 
  173. each with a buffer of 100 characters. Each of these buffers are 
  174. assigned to a function key, so, if you press F1 while editing a file, 
  175. the text that you entered in the first macro gadget will be 
  176. automatically entered into your file. This can be useful if you find 
  177. yourself repeating a phrase or sentance a lot.
  178.  
  179. To save this setup, select SAVE SETUP from the menu. This writes a 
  180. 1075 byte long file to your disk called TEXTENGINE2.1.CONFIG which 
  181. contains information about the screen colours, printer setup, wordwrap
  182. status, macros, and whether you are using NTSC or not. This file is 
  183. automatically loaded up when Textengine is started. If TextEngine 
  184. cannot find the configuration file on the disk, or the file does not 
  185. exist, then the default settings are used.
  186.  
  187. Please note that the setup file for version 2.1 of TEXTENGINE is 
  188. incompatiblae with the file for versions 1 & 2. Because of this, the 
  189. filename has been changed to TEXTENGINE2.1.CONFIG, and I am afraid 
  190. that you will have to reconfigure the program again to suit you.
  191.  
  192.  
  193. Final note.
  194. I hope you find this program as useful as I do, and get many miles of 
  195. printout from it!
  196.  
  197. Many thanks to Mark Higgins and Martin Guy for testing and ideas.
  198. Mega banana-like hellos to Peter Lee, James Stuart (both Acorn users -
  199. yeuch), Warren Saunders, Gary Taylor, and everyone else.
  200.  
  201. Keep on Amiga-ing.
  202.  
  203. Potential Difference rule the Nimbus network!
  204.  
  205. Anyway the wind blows...
  206.  
  207.