home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / apps / word / dbwriter / quickdoc.txt < prev    next >
Text File  |  1992-07-10  |  48KB  |  920 lines

  1.                                 dbWRITER 1.8
  2.                       ================================ 
  3.                       Copyright 1991,1992 David Becker
  4.                               GEnie D.Becker8
  5.                            Compuserve 73030,3562
  6.  
  7. dbWRITER was originally an experiment in alternative interfaces, long before
  8. my ZeST programs were developed. I wanted to create a custom graphic user
  9. interface that would closely resemble GEM and be portable to the IBM
  10. platform. I had written a simple text editor in my FontSwap2 program that I
  11. wanted to expand so it became the perfect vehicle in which to test my
  12. alternative interface ideas.
  13.  
  14. dbWRITER has been floating around in various BETA stages for quite a few
  15. months. The first OFFICIAL RELEASE came as a result of much prompting by
  16. other users. dbWRITER has never seen any serious testing therefore I would
  17. appreciate your input when you are confronted with bugs. I hope to continue
  18. perfecting dbWRITER in my spare time as well as adding many new and requested
  19. features.
  20.  
  21. I have released dbWRITER in three parts. The dictionary file probably won't 
  22. be changed for some time so you will only have to download it once. The 
  23. thesaurus is also available online and will not be changed. The main program 
  24. and support modules will be released anytime an update warrants it. dbWRITER 
  25. and all my past programs are freeware, you can copy them, sell them through 
  26. the user group or upload them to local BBS systems. You use dbWRITER at your 
  27. own risk. 
  28.  
  29. dbWRITER is configurable and will therefore run on all ST platforms. One
  30. megabyte or more is recommended though you can run without the dictionary on
  31. a 520ST. dbWRITER really needs more than one megabyte and a hard drive if it
  32. is to be fully appreciated. I recommend TurboST by Softrek to dramatically 
  33. speed up text scrolling (Programmers note: I use the Line-A-Routine BITBLT 
  34. to scroll the screen). You will need a monochrome monitor.
  35.  
  36.  
  37. Starting Out 
  38. ============
  39. I must begin by stressing the importance of regularly saving your document to
  40. disk. If you are about to make any major change to your document such as a
  41. global column or width reformat, or do a spell check, make sure you've saved
  42. your work first. dbWRITER is fairly solid, but any application is bound to
  43. have hidden bugs, please proceed safely at all times.
  44.  
  45. This manual is an overview of the primary commands and functions needed to 
  46. operate dbWriter. It assumes an understanding of the fundamentals of word 
  47. processing and general knowledge of the ST's mouse and keyboard. 
  48.  
  49. Key combinations listed in this documentation may include the alternate key
  50. <A>, the control key <C>, the LEFT shift key <S> or any combination of these.
  51. <CS>L would require that you hold down the LEFT shift key and control key
  52. while pressing the letter L.
  53.  
  54.  
  55. Editing Text 
  56. ============
  57. The dbWRITER work space is divided into two areas. The uppermost blank area
  58. is your text editing screen. This is where you will be typing and
  59. manipulating your document. Just below at the bottom of the screen is the
  60. command line. You can move the cursor around your document using the arrow
  61. keys or by pointing and clicking with the left mouse.
  62.  
  63. Here are the basic editing principles, 
  64.  
  65. - BACKSPACE moves the cursor to the left and deletes a character. It drags 
  66.   all text 'to the end of the line' along with it. BACKSPACE at the 
  67.   beginning of a blank line deletes that line and moves the cursor up and on 
  68.   to the end of the line above.
  69.  
  70. - DELETE deletes the character that the cursor resides on and also drags
  71.   everything else 'to the end of the line' left. The cursor stays put. DELETE
  72.   will remove a blank line and move all lines up one space.
  73.  
  74. - <SHIFT>DELETE deletes any line, empty or not and moves all lines up one 
  75.   space.
  76.  
  77. - When RETURN is used at the end of the last line in your document, the
  78.   cursor jumps to the beginning of a new blank line below. 
  79.  
  80.   When RETURN is pressed at the end of a line within your document it 
  81.   inserts a blank line below and moves the cursor to the beginning of this 
  82.   new line.
  83.   
  84.   When RETURN is pressed at the beginning of a line it inserts a blank line 
  85.   at the cursor, moves the existing line down then moves the cursor down to 
  86.   the beginning of this line.
  87.   
  88.   When RETURN is used within a line, the line is split into two parts and
  89.   everything from the cursor position to the end of the line is moved to the
  90.   line below, inserting a blank line if nescessary. The cursor is also 
  91.   moved down to the beginning of the line. 
  92.  
  93. There are two distinct modes for text entry. INSERT and OVERWRITE. You toggle
  94. between the two modes using the INSERT key. INSERT mode is the default and 
  95. displays a pointing arrow while OVERWRITE displays a crosshair.
  96.  
  97. INSERT MODE (this is where you will spend most of your time) 
  98.  
  99. - When entering text or using the SPACEBAR, all other text in front is pushed
  100.   forward. Each time a letter is typed, the cursor moves one space to the
  101.   right awaiting the next keypress.
  102.  
  103. OVERWRITE MODE 
  104.  
  105. - When entering text or using the SPACEBAR, all existing text is overwritten
  106.   by the new characters. Nothing gets pushed forward. Each time a letter is 
  107.   typed, the cursor moves one space to the right awaiting the next keypress.
  108.  
  109.  
  110. Word Wrap
  111. =========
  112. Word wrap can be toggled on and off by clicking within the command line box 
  113. at the bottom of the screen. When word wrap is enabled, any text extending 
  114. past the right margin will be automatically wrapped to the next line as you 
  115. type. Word wrap only works when there is a blank line beneath. Word wrap 
  116. does not effect editing, only typing when the cursor is at the end of the 
  117. line. This way you can format and play with any given line after it has been 
  118. typed without the irritation of the last word always wrapping around by 
  119. mistake. 
  120.  
  121.  
  122. Command Line 
  123. ============ 
  124. The bottom of the screen contains the command line. From left to right you
  125. see the line number indicator which shows the line the cursor resides on.
  126. Click within this box to jump to any line number. Next to that is the page
  127. number indicator displaying the page that the cursor resides within. Click
  128. here to jump to the beginning of any page. The bottom of this box doubles as
  129. a document indicator, either DOC1 or DOC2 (you toggle between two documents
  130. using <C>F). The word wrap indicator displays the status of automatic word
  131. wrap, dark for on and light for off. Click here to toggle between these to
  132. modes. The 'quick pick grid' is next and lets you [L] Load a text file, [S]
  133. Save a text file, [P] Print the current document or [D] look up any word in
  134. the Dictionary. The dbWRITER logo toggles the drop down menus on and off. The
  135. left and right margin indicators reflect the ruler line and its margin
  136. settings. Click here to directly enter a new setting. Page length defaults to
  137. 60 but can be changed by clicking in this box. Page length, margins, word
  138. wrap and TAB settings can be custom saved and restored using the ruler
  139. function <A>T. The system memory status box also doubles as a clipboard
  140. indicator. Press this button to call clipboard functions when the clipboard
  141. is full of text. Finally the CAP LOCK indicator has an up arrow for uppercase
  142. lock and a down arrow for normal lower case typing. Use the CAP LOCK key on
  143. the keyboard or click within this box.
  144.  
  145.  
  146. Drop Down Menus 
  147. ===============
  148. dbWRITER uses its own custom style of drop down menu. If you are familiar 
  149. with GEM menus then you will have no trouble with these. Simply touch the 
  150. mouse cursor at the very top of the edit screen to the left, right or center 
  151. to 'drop a menu'. Menu choices flash as you run the mouse pointer over them.
  152. Click the left button to choose or move the mouse off the menu left or right
  153. to cancel. Not all functions are represented in the menus, only the most
  154. important (some may be redundant). Click the dbWRITER logo at the bottom in
  155. the command line to toggle menus off and on.
  156.  
  157.  
  158. Text Attributes (italic, bold, underline) 
  159. =========================================
  160. There are a few ways of setting bold, italic and underline attributes within
  161. your document. Most likely you will want to change to one of these as you are
  162. typing. Simply press F1(italic), F2(bold) or F3(underline) and then continue
  163. entering text. The correct attribute will be reflected within the text editor
  164. as you type. What has happened is dbWRITER has embedded an invisible control
  165. character at the point where the function key was first pressed and again 
  166. just to the right of the cursor. As you type, the last hidden control 
  167. character is pushed forward and all text lying between the two control 
  168. characters is displayed as either bold, italic or underlined. The most 
  169. common method of exiting a chosen attribute is by pressing the RIGHT arrow 
  170. key once. This forces the cursor to skip over the last invisible control 
  171. character and allows you to once again type with normal text. You could also 
  172. use the UP or the DOWN arrow key to exit attribute selection. You can also 
  173. set up dbWRITER through the printer driver screen <A>W so that punctuation 
  174. automatically exits any attribute. You can have up to 3 different text 
  175. attributes on any line at the same time. Should you have difficulty with 
  176. bold, italic or underline text and a word gets scrambled, press F8 to clear 
  177. the line of all attributes and try again.
  178.  
  179. You can also set attributes 'after the fact' by placing the cursor on any
  180. chosen word and pressing one of the function keys. If you want to set more
  181. than one word, a sentence or a paragraph then create a text block (hold down
  182. the left mouse and drag down) and choose bold, italic or underline from the
  183. block options menu (right mouse button after the block is set). When a block
  184. is highlighted, you can actually see the hidden control characters!
  185.  
  186. If you want to save your document as ASCII text you can press <S>F5 after
  187. first saving a copy of your work to disk. This function will clear ALL hidden
  188. control characters and therefore all text attributes. <A>E lets you delete
  189. only ONE type of text attribute from the entire document.
  190.  
  191.  
  192. Dictionary 
  193. ========== 
  194. The dbWRITER dictionary is over 40,000 words long and is ASCII text. You can
  195. change words in the dictionary if you follow some simple rules. Do not add or
  196. delete any lines. Do not change spacing on any of the lines. Make sure the
  197. words changed are alphabetic, alongside other words beginning with the same
  198. sequence of letters with one space between each word. I encourage users to
  199. continue updating the dictionary. Canadians will want to change color to
  200. colour and check to cheque, etc.
  201.  
  202. dbWRITER also allows you to compile a personal supplemental dictionary file.
  203. It will be automatically created during spell check and you will be prompted
  204. to save this personal dictionary file to disk before exiting the program.
  205.  
  206. One megabyte users should be aware that the dictionary requires about 380K of
  207. available memory. Check the system memory status display within the command
  208. line and make a backup of your document BEFORE you load the dictionary. You
  209. can purge the dictionary from memory using <A>X after the spell check is
  210. complete. Alternatley you may wish to take advantage of the "Memory Saver" 
  211. spell check option within the configuration screen <A>C 
  212.  
  213. You can look up any word or even a part of a word by placing the cursor down
  214. on the first letter of the text and clicking 'D' within the quick pick grid
  215. or pressing <C>V. The spell check window will open and if the word is present
  216. it will be highlighted. If not, dbWRITER will show you a list of correctly
  217. spelled words that come close. You can use the up and down arrow to page
  218. through the dictionary or click on the arrows at the bottom of the spell
  219. check window. You can also use SHIFT-UP or DOWN ARROW to fast reverse or fast
  220. forward through the dictionary. If you hit ESC or any other key you can enter
  221. a new word into the edit line at the bottom of this window and then press
  222. RETURN to look it up. The right mouse button or UNDO exits the spell check
  223. window (as long as you are not still entering a word on the edit line).
  224.  
  225. If you want to spell check your entire document then press <C>X. dbWRITER 
  226. will start at the top of your document and everytime it sees an unrecognized 
  227. word it will place a flashing black cursor on the word and bring up a dialog 
  228. box with three options, 
  229.                            SKIP, ADD and CORRECT.
  230.  
  231. If you know the word is spelled correctly and you want to add it to your
  232. personal dictionary then choose ADD. If you know the word is spelled
  233. correctly but it is an oddball then press SKIP and the spell check won't
  234. bother you again if it sees another the same. If you want the computer to
  235. help you correct the highlighted word then press CORRECT and the spell check
  236. window will appear. If you see the correct spelling within the window you can
  237. click on it with the left mouse button and it will replace the original word
  238. within the edit line at the bottom. If not, you can page through the 
  239. dictionary or hit ESC or any key to manually type another spelling within
  240. the edit line. Hit RETURN or the right mouse button to exit the spell check 
  241. window, replace the old word with the new spelling and continue on with the 
  242. rest of the document. Your personal dictionary will only be updated when you 
  243. quit this session of dbWRITER. Always quit using the UNDO key!
  244.  
  245. You can cancel spell check by pressing UNDO while the computer is scanning
  246. words. The bottom left of the command line shows you the progress during
  247. spell check. If the dialog (SKIP, ADD, CORRECT) is on the screen you can hold
  248. down the right mouse button while pressing RETURN to also cancel spell check.
  249.  
  250. dbWRITER configuration <A>C contains an option called "Memory saver spell 
  251. check". When this option is active the spell check uses only half the 
  252. normal memory by doing two passes and loading only half the dictionary at a
  253. time. Word searches are done by scanning the dictionary disk file instead 
  254. of loading the entire dictionary resident in memory. This dictionary disk 
  255. scan can take a few seconds but uses very little memory. 
  256.  
  257.  
  258. Thesaurus 
  259. ========= 
  260. The dbWRITER thesaurus is contained within four files:
  261.  
  262.               THES1.DAT, THES2.DAT, THES3.DAT and THES4.DAT
  263.  
  264. These files should be in the same directory as dbWRITER or if you
  265. choose to share these files with the dbWRITER accessory (see configuration 
  266. instructions below) they will be in the folder DICT on drive C: 
  267.  
  268. There is a drop down menu on the far left (bottom) that will activate the 
  269. thesaurus screen or hit the key combination <CA>T 
  270.  
  271. The thesaurus screen pops up in the middle of the text editor and awaits 
  272. input. Simply type the word you wish to search and hit RETURN. dbWRITER 
  273. looks at the files on your hard drive and does not actually load the 
  274. thesaurus into memory. This uses very little RAM. After a few seconds, if 
  275. the word was found, you will see the thesaurus choices appear at the 
  276. bottom of the thesaurus window. The combined thesaurus files contain almost 
  277. 30,000 words! 
  278.  
  279. Press RETURN to input another word or click again within the box. 
  280. The thesaurus search will continue to expand until it exhausts itself or 
  281. until you hit UNDO. Click the right mouse button, input an empty string or 
  282. press UNDO to exit the thesaurus window.
  283.  
  284.  
  285. Mail Merge Database
  286. ===================
  287. <S>F6 enters the mail merge database. One megabyte users should not enter
  288. the database unless they plan on using it. I allocate the needed memory only
  289. when entering mail merge for the first time, not when dbWRITER is first run. 
  290.  
  291. This is a simple address book/cardfile that allows you to send form letters 
  292. to anyone included within the database. This feature allows you to imbed 
  293. both the salutation and inside address into your document using SHIFT-F7 or 
  294. SHIFT-F8. For example, your form letter might start like this:
  295.                                         
  296.                             Dear SHIFT-F7,
  297.  
  298. and everytime a new letter is printed the computer inserts a different name
  299. onto this line. Same thing for the inside address (can also be used for
  300. envelopes).
  301.  
  302.              Here are the options within mail merge,
  303.  
  304.              F1   Mark an address for inclusion or exclusion 
  305.                   in the current printouts. There will be a cross 
  306.                   in the upper left corner or a check mark. A 
  307.                   check mark will INCLUDE the entry when mail merge
  308.                   printing and a cross will SKIP the entry.
  309.  
  310.              F2   Sort all the address cards. Mail merge sorts using
  311.                   the last name on the salutation line. For example, if 
  312.                   your salutation line is 'Mr. David Becker' the sort 
  313.                   is smart enough to look at 'Becker' instead of 'Mr.' 
  314.  
  315.              F3   Search for any string in any address card. 
  316.    
  317.              F4   Load a mail merge database (extension of .MM)
  318.  
  319.              F5   Print one or all the address cards 
  320.  
  321.              F6   Erase any one or all of the cards 
  322.         
  323.              F7   Save your personal mail merge database to disk
  324.  
  325.              F8   Go to (jump to) any card number you wish
  326.  
  327. Use the arrow keys to cycle through the cards. Hit UNDO to return back to the
  328. dbWRITER edit screen. Hit RETURN to enter edit mode. The black cursor appears
  329. on line one (the salutation line). Type your information onto each line. You
  330. must continue hitting RETURN after each entry line to exit edit mode.
  331.  
  332.  
  333. Global Search and Replace 
  334. ========================= 
  335. <C>S brings up the search and replace screen. If you want to search for a 
  336. text string then click in the box at the top, enter your target text and 
  337. press RETURN. If you are going to search and then replace this text with an 
  338. alternate string then enter this on the next line using the same process.
  339.  
  340. The next set of buttons let you choose how much of you document to search 
  341. within. You can search forwards from the current cursor position to the 
  342. end of your document. You can search backwards from the end of the 
  343. document to the cursor or simply search every line from top to bottom. 
  344. Highlight the correct button by clicking the left mouse on it.
  345.  
  346. Below are the WITH QUERY, WITHOUT QUERY buttons. These buttons function only
  347. during search and replace. WITH QUERY prompts you before replacing text 
  348. and WITHOUT QUERY just replaces text on its own without asking.
  349.  
  350. The button to the right is CASE SENSITIVE. When this is darkened the computer
  351. looks for an exact match when searching text strings. Upper case and lower
  352. case MUST match exactly. When this button is light, case does not matter when
  353. searching for text.
  354.  
  355. The next set of buttons, ITALIC, BOLD, UNDERLINE only work with search and 
  356. replace. The computer can search for the text string in the top box and turn 
  357. it into one of the three chosen attributes, italic, bold or underlined. The 
  358. text is not replaced by the string in the second 'replace string' box but is 
  359. simply converted to the chosen attribute.
  360.  
  361. To begin a simple search WITHOUT replace press the bottom left button on
  362. this screen titled SEARCH or hit RETURN. F10 will continue searching after 
  363. each occurrence. 
  364.  
  365. To begin a search AND replace press the bottom center button titled
  366. SEARCH-REPLACE.
  367.  
  368. To begin a search and attribute change press the bottom right button titled 
  369. ATTRIBUTES. UNDO cancels any search underway or exits this screen. 
  370.  
  371.  
  372. Auto Load Options 
  373. ================= 
  374. dbWRITER will automatically load a ruler line (DBWRITER.TAB), a mail merge 
  375. database file (DBWRITER.MM) and a set of macros (DBWRITER.MAC) if it finds 
  376. the correct filename present in its directory. The dictionary can be 
  377. loaded automatically through the configuration dialog <A>C 
  378. (You can't auto load the dictionary if memory saver is turned on). 
  379.  
  380.  
  381. Block Options 
  382. ============= 
  383. There will be many times when you wish to manipulate only a small portion of
  384. your document. This can be accomplished by defining a text block. The easiest
  385. way of doing this is to place the cursor at the beginning of your chosen text
  386. by pointing and clicking the left mouse. Hold down the button and drag down
  387. and to the right (or only to the right) with the button depressed. You can
  388. move the highlighted area up and down as long as the mouse button is held.
  389. It's easy to highlight only one letter, one word, a sentence or a paragraph! 
  390. If you drag past the bottom of the edit screen the document will begin to 
  391. scroll up. Let go of the mouse button when you have highlighted the chosen 
  392. text. If you mess up you can hit ESC and try again.
  393.  
  394. With a defined block, the right mouse button no longer calls your custom
  395. keypress but instead opens the block option dialog box. Here are 15 options
  396. for your chosen text. You can click the left mouse on any option or press the
  397. correct number or letter to activate it.
  398.  
  399.                 1. Delete Block (There is no safety buffer for 
  400.                    deleted blocks. All text beneath will snug up 
  401.                    into the deleted area.)
  402.  
  403.                 2. Copy Block (You can't copy a text block into a
  404.                    text block. Move the cursor to the point of
  405.                    insertion and you can copy into an existing
  406.                    sentence or start from a blank line. The
  407.                    original block remains highlighted.)
  408.  
  409.                 3. Move Block (A copy is made at the cursor 
  410.                    position then the original block is deleted.) 
  411.  
  412.                 4. Write to Disk (A copy of the chosen text is 
  413.                    saved to disk under a filename of your choice.)
  414.  
  415.                 5. Print Block (Only the chosen text is printed 
  416.                    together with any chosen attributes.) 
  417.  
  418.                 6. Italic (Change the entire block of text to 
  419.                    italic.) 
  420.  
  421.                 7. Bold (Change the entire block of text to bold.)
  422.  
  423.                 8. Underlined (Change the entire block of text to
  424.                    underlined.)
  425.  
  426.                 9. Clear Attributes (Erase all bold, italic and 
  427.                    underline attributes from the chosen text. 
  428.                    Control characters become visible within
  429.                    highlighted text.) 
  430.  
  431.                 A. Justify Block (Flush left or flush right. If 
  432.                    only a small part of a line is highlighted the 
  433.                    whole line is still justified.) 
  434.  
  435.                 B. Copy to Clipboard (This is the only way to copy 
  436.                    blocks into blocks or to copy between two 
  437.                    seperate documents. The content of the 
  438.                    clipboard remains intact even if you load 
  439.                    another document. Clipboard functions are 
  440.                    called by clicking in the system memory box
  441.                    You can stack text blocks within the clipboard 
  442.                    or replace text in the clipboard with the new 
  443.                    block.)
  444.  
  445.                 C. Indent Block (Once again if a part of a line is 
  446.                    highlighted the whole line will still be 
  447.                    affected. Positive numbers indent right, 
  448.                    negative numbers indent to the left.)
  449.  
  450.                 D. Reformat Width (The easiest way to reformat a 
  451.                    paragraph is with F9 but this accompishes the 
  452.                    same thing with your chosen text block.)
  453.  
  454.                 E. Upper Case (The entire block is changed to 
  455.                    upper case letters. Numbers and special 
  456.                    characters are not affected.)
  457.  
  458.                 F. Lower Case (The entire block is changed to 
  459.                    lower case.)
  460.  
  461. Click the right mouse button again or hit UNDO to exit block options 
  462. without making a choice. You can also use key commands to set a block:
  463.  
  464.      <C>A Block start     <C>Z Block end    <C>U Use the block options
  465.  
  466. or check out the far left drop down menu under text block options.
  467.  
  468. The configuration screen has an option called "Auto options after
  469. setting text block". When this is enabled the text block option dialog will 
  470. display after you set your text block by dragging the mouse. 
  471.  
  472.  
  473. Configure dbWRITER 
  474. ==================
  475. <A>C enters the custom configuration screen. These settings reflect the way
  476. dbWRITER operates when next run. You can set the maximum number of lines in
  477. the dbWRITER editor. This option will save memory for those using a megabyte
  478. or less and only wanting to type short letters. The default is 4000 lines. I
  479. set it at 20000 on my MegaSTe and at 2000 on my 1040ST. (If the maximum line
  480. setting is exceeded while using dbWRITER you will see a warning dialog
  481. advising you to save your document. Please change your configuration and run
  482. dbWRITER again.)             
  483.  
  484. Maximum number of lines for the clipboard defaults to 99. If you are going 
  485. to be copying between two seperate documents you will need this set higher. 
  486.  
  487. Maximum number of mail merge names. If you use dbWRITER in your business 
  488. you may want this set quite high, or maybe you have lots of friends!
  489.  
  490. Text block auto options (as descibed in the section on text blocks) is next.
  491.  
  492. You can auto load the dictionary when dbWRITER is first run by selecting 
  493. the next option. You can't auto load the dictionary with memory saver. 
  494.  
  495. The next two options set the dictionary and thesaurus paths. When using the
  496. dbWRITER accessory (available on GEnie and Compuserve) you can share the
  497. dictionary and thesaurus instead of having seperate files for each
  498. application. Follow the instructions included with the dbWRITER desk
  499. accessory and after the accessory has created and installed the new
  500. dictionary folder (it creates a folder called DICT on drive C:) and you have
  501. copied the thesaurus files into it, you can share these between the dbWRITER
  502. program and the dbWRITER accessory. If you do not use the dbWRITER accessory 
  503. than the dictionary file and thesaurus files must be in the same directory as
  504. DBWRITER.PRG
  505.  
  506. The next box tells dbWriter to save a custom ruler line everytime you save
  507. a text file. The ruler will share the same name as your text file but will 
  508. carry the proper .TAB extension. Ruler lines are auto loaded when they 
  509. share the same name as text files (example: LETTER.TXT and LETTER.TAB). 
  510.  
  511. The last option is called "Memory saver spell check". When this option is
  512. active the spell check uses only half the normal memory by doing two passes
  513. and loading only half the dictionary every time. Word searches are done by
  514. scanning the dictionary disk file instead of loading the entire dictionary
  515. resident in memory. This dictionary disk scan can take a few seconds but uses
  516. very little memory.
  517.  
  518. Many other settings are saved with your configuration such as screen colour,
  519. key click, visible page breaks, and the custom right mouse button press to
  520. name a few.
  521.  
  522. Did'nt I mention the custom right mouse button key press? This is cool! 
  523. Press <A>F and dbWRITER will ask for a custom key press to assign the right 
  524. mouse button. Any key combination supported by dbWRITER! Now everytime you 
  525. press the right mouse button you can call your favorite function.  
  526.  
  527.  
  528. Printer Driver Configuration 
  529. ============================
  530. <A>W brings up the printer driver screen. Here you can create you own 
  531. custom drivers by simply entering the DECIMAL values for bold, italic, 
  532. underline and form feed right from your printer manual. Just click the 
  533. CHANGE button next to each attribute, enter the codes and when you are done 
  534. save your new printer driver as PRINTER.DBP for auto load everytime you run 
  535. dbWRITER. (If your printer supports subscript, superscript, light text or 
  536. other special effects you can easily substitute these codes for bold, 
  537. italic or underline!) 
  538.  
  539. At the bottom next to the SAVE and LOAD buttons you can choose the device 
  540. to print to, either the serial port (modem) or the parallel port (this will 
  541. most likely be what you are using and is the default). 
  542.  
  543. The next button decides whether punctuation exits attribute selection. 
  544. For example, if you are typing using bold, should a period, question mark or
  545. exclamation mark exit you back to normal text?
  546.  
  547. The command button lets you send any custom printer string to your printer
  548. and the form feed button ejects a page from your printer. 
  549.  
  550. All other settings are saved with your printer driver. 
  551.  
  552.  
  553. Ruler Line 
  554. ==========
  555. You can set and remove TAB marks (small triangles) by pointing and clicking on
  556. the ruler line. If you click and hold the left button a vertical line will 
  557. appear that you can slide back and forth. Let go of the mouse button to set 
  558. your TAB! Normally you would click once quickly on any existing TAB marker to 
  559. remove it or click on any empty space to set a new TAB marker.
  560.  
  561. Left and right MARGINS can also be set by clicking on top of the MARGIN within
  562. the ruler line (the black blocks with L or R inside) and holding down the
  563. mouse button. This is a bit tricky, you must click between the horizontal
  564. ruler line and the top of the command line. Drag the double vertical lines 
  565. left or right and then let go of the button. MARGIN settings will change 
  566. within the indicator box as you go.
  567.  
  568. You can save and load custom rulers using <A>T or even setup dbWRITER's 
  569. configuration to load a custom ruler when run. If a ruler line shares the 
  570. same name as a text file (example: LETTER.TXT and LETTER.TAB) then this 
  571. ruler line will be loaded along with the text file. Printout margins (left 
  572. and top) are saved with your ruler line.
  573.  
  574.  
  575. Printout Configuration Screen 
  576. ============================= 
  577. The first two options set the top and left margin for only the printed page, 
  578. not for the displayed document. These settings are saved with your custom 
  579. ruler line.  
  580.  
  581. Next you can set the number of copies to be printed. The countdown box at the
  582. bottom right of this screen displays the total number of complete copies (not
  583. pages but entire documents) sent to the printer. This indicator resets
  584. everytime you close the printout configuration box.
  585.  
  586. If you want to send a form feed (page eject) after each page is printed then 
  587. set this option to YES.
  588.  
  589. The next box tells dbWRITER to send your entire document continuously to the 
  590. printer without prompting you at all or to alternately ask after each page.
  591.  
  592. If you have entered the mail merge database and inserted a Shift-F7 or 
  593. Shift-F8 into your document then you can print using the mail merge database. 
  594. This option will be lightened if the database is not available.
  595.  
  596. The next option sets the page number that will begin the printout.  
  597.  
  598. The last option sets the number of lines between pages. It may be easier to
  599. set the automatic perforation skip on your printer and just print from
  600. dbWRITER continuously. If you are printing labels then this option will be 
  601. invaluable. 
  602.  
  603.  
  604.  
  605. Extras and Reminders 
  606. ====================
  607.  
  608. - Press HELP to find the current version number.
  609.  
  610. - UNDO quits dbWRITER and returns you to the GEM desktop.
  611.  
  612. - The 'quick pick grid' next to the dbWRITER logo lets you [L] Load a text
  613.   file, [S] Save a text file, [P] Print the current document or [D] look
  614.   up any word in the Dictionary.
  615.  
  616. - The cursor control arrows are non-destructive and the cursor floats freely.
  617.   You can use the arrows or mouse to move the cursor ANYWHERE on the screen 
  618.   above the last line of your document.
  619.  
  620. - SHIFT-LEFT ARROW takes you to the beginning or SHIFT-RIGHT ARROW to the
  621.   end of any line.
  622.  
  623. - If you've just screwed up a line you can hit CONTROL-UNDO to call the
  624.   safety buffer and restore the line.
  625.  
  626. - Click the left mouse button once quickly and the cursor will drop wherever
  627.   the arrow is pointing. Drag with the left button to set a text block. Use
  628.   the right button to call up block options or hit ESC to clear the block.
  629.  
  630. - CONTROL-RETURN centers any line of text.
  631.  
  632. - The INSERT key toggles between insert and overwrite mode (pointing
  633.   arrow or crosshairs).
  634.  
  635. - You can pass parameters to dbWRITER. If you have Mega STe - TOS 2.05 or
  636.   better just 'pick up' your text file with the mouse and 'drop it' on top of
  637.   the dbWRITER.PRG icon. The program will run and then will automatically
  638.   load your document! You can 'install' any file with the extension .TXT or
  639.   .DOC on all TOS versions and have dbWRITER do the same thing when you
  640.   double-click on the text file!
  641.  
  642. - F9 reformats the current PARAGRAPH to the margins.
  643.  
  644. - If you place the mouse pointer at the very bottom of the screen you can
  645.   scroll through your document by pressing the left and right buttons.
  646.  
  647.  
  648. All Currently Supported Functions in Brief 
  649. ==========================================
  650.  
  651. <C>Q ........... Calendar. (Defaults to system date, use the arrow keys to
  652.                  change the month or year. UNDO or right mouse to exit.)
  653.  
  654. <C>W ........... Invert the screen colours. (Black on white / white on black.
  655.                  Colours are saved automatically with your configuration.)
  656.  
  657. <C>K ........... Toggle key click on and off. (Default is off. Key click is 
  658.                  also saved with your configuration.)
  659.  
  660. F4 ............. Load an ASCII text file. (You can alternately click the [L]
  661.                  within the 'quick pick grid'. dbWRITER offers a basic import
  662.                  option when it recognizes a non-ASCII file. Wordwriter and 
  663.                  First Word Plus importation is also supported.)
  664.  
  665. F5 ............. Merge a text file. (Merge another small file at the cursor.
  666.                  This file must be less then 500 lines.) 
  667.  
  668. F6 ............. Save a password encrypted text file. (Encrypted files are
  669.                  automatically recognized when loaded and you are then 
  670.                  prompted for the correct password. This function requires
  671.                  a lot of memory, make a backup first.)
  672.  
  673. F7 ............. Save a text file. (You can also click [S] within the grid.)
  674.  
  675. <CS>F7 ......... Save a text file using the last filename. (You must have  
  676.                  first saved your file at least once. The previously
  677.                  saved text file will be renamed to BACKUP.TXT)
  678.  
  679. <C>H ........... Toggle slow scroll on and off.
  680.  
  681. <C>N ........... Automatic scroll. (Use the up or down arrow key to start the
  682.                  scroll in the chosen direction. Try it with slow scroll.)
  683.  
  684. F10............. Continues a string search initiated with CONTROL-S. 
  685.  
  686. <C>F ........... Flip between two separate text files. (You can use the
  687.                  clipboard to copy text back and forth between two files. The
  688.                  two text buffers work best when you have MORE than one meg
  689.                  of memory. I allocate extra memory only when this function is
  690.                  called. dbWRITER remembers the cursor position, line and
  691.                  page for each document and returns you to the correct last
  692.                  position when flipping back and forth.)
  693.  
  694. <CA>T .......... dbWRITER Thesaurus 
  695.  
  696. <C>T ........... Jump to the top of your document. (CLR does the same thing.) 
  697.  
  698. <C>B ........... Go to the bottom of the current document. 
  699.  
  700. <C>M ........... Mark a line (bookmark) and jump to it any time with <C>J.
  701.                  (The line changes to light italic text. Hit ESC to clear
  702.                  a marked line.)
  703.  
  704. <C>A ........... Mark the beginning of a block of text. (You can also hold 
  705.                  down the left mouse button and drag over text to set a 
  706.                  block. If you continue dragging past the last line, the text 
  707.                  will scroll up. After the block is highlighted use the right
  708.                  mouse button to call up the option screen. Printer control 
  709.                  codes become visible within blocked text. Use ESC to clear a 
  710.                  text block.) 
  711.  
  712. <C>Z ........... Mark the end of a text block. 
  713.  
  714. <C>U ........... Calls the block option menu (or use the right mouse button). 
  715.  
  716. <C>G ........... Go to any line number (or click within the command line). 
  717.  
  718. <C>E ........... Go to any page number (or click within the command line).
  719.  
  720. <CS>TAB ........ Toggle between destructive and non-destructive TAB. (When you
  721.                  hit the TAB key it either pushes everything in its path 
  722.                  ahead or just skims over existing text.)
  723.  
  724. <SA>T .......... Typewriter mode.(A checkmark becomes visible when this option
  725.                  is active. After hitting RETURN, the current line of text is 
  726.                  sent directly to the printer.) 
  727.  
  728. <C>S ........... Search and replace screen. (Click within the text entry boxes
  729.                  at the top of this screen to enter your search strings. You
  730.                  can search/replace FORWARD from the cursor position,
  731.                  BACKWARDS from the current cursor position or everything in
  732.                  your entire document. You can search/replace WITH QUERY and 
  733.                  you will be prompted to confirm each match. You can also 
  734.                  search/replace CASE SENSITIVE or without caring about upper 
  735.                  or lower cases. Finally you can search for a text string and 
  736.                  set its attribute to either italic, bold or underlined! 
  737.                  Click on one of the three choice buttons at the bottom of 
  738.                  this screen to initiate the search/replace. UNDO or the 
  739.                  right mouse button exits.)
  740.  
  741. <CS>D .......... Here you can set the editor to single or double spacing or
  742.                  automatically reformat the entire document from single to 
  743.                  double spaces and back again.
  744.  
  745. <CS>P .......... Page preview. (Standard page sizes, side by side. Sixty 
  746.                  lines per page is the maximum supported by page preview.)
  747.  
  748. <CS>I .......... Auto or manual indent. (Automatic indent centers the entire
  749.                  document left to right. Manual indent accepts positive or 
  750.                  negative numbers. Positive shifts text right, negative shifts
  751.                  text to the left. If AUTO indent does not seem to work it 
  752.                  is likely because one or more lines are too long.)
  753.  
  754. <CS>T .......... Center one page. (If you have no more than one page of text
  755.                  you can center it horizontally AND vertically!)
  756.  
  757. <CS>R .......... Reformat width. (This option can reformat your document
  758.                  width to match the right and left margins. You can also
  759.                  define a text block and reformat from the block options
  760.                  menu. Make a backup of your document before reformatting. 
  761.                  If you want to reformat only the paragraph the cursor is 
  762.                  touching then press F9.)
  763.  
  764. <CS>F .......... Reformat full-out. (You will be prompted to first reformat
  765.                  the document width. This usually results in a cleaner 
  766.                  justification. Backup your document before reformatting.)
  767.  
  768. <CS>L .......... Reformat the entire document flush left or right. 
  769.  
  770. <C>V ........... View the dictionary. (Or click on the [D] in the quick pick
  771.                  grid on the command line. The dictionary will be loaded if
  772.                  this is the first time you have chosen the option. If you 
  773.                  are using a hard drive then this is relatively painless. The
  774.                  dictionary will be retained in memory from this point on.
  775.                  The file DICTIONA.RY should be in the same folder as 
  776.                  dbWRITER. You can place the cursor on any word, or even in 
  777.                  the middle of a word, and the computer will look it up in 
  778.                  the dictionary. If the word is present, it will be 
  779.                  highlighted. If not, hunt through the dictionary using the 
  780.                  up or down arrow. You can also type alternate words into 
  781.                  the dictionary window and then press RETURN to search 
  782.                  again. UNDO or right mouse exits.) 
  783.  
  784. <C>X ........... Spell check the entire document. (When confronted with a 
  785.                  word it does not recognize, the ST gives you the option of 
  786.                  SKIPPING the word, ADDING it to your personal dictionary or 
  787.                  CORRECTING it. dbWRITER will look up the closest match to 
  788.                  the incorrect word and then display a list. If you see the 
  789.                  correct spelling just click with the left mouse. You can 
  790.                  also use the up or down arrow to browse the dictionary. Hit 
  791.                  RETURN to accept the word or any other key to edit it. Hit 
  792.                  UNDO during spell check to cancel or use RETURN while 
  793.                  depressing the right mouse button if the dialog box is 
  794.                  present. 
  795.  
  796. <A>X ........... Purge the dictionary from memory. Restores all used memory. 
  797.                  You will have to reload the dictionary next time you use it. 
  798.  
  799. <A>P ........... Print the current document. (You can also click [P] within
  800.                  the grid. You can print single pages with a prompt between 
  801.                  pages or print continuously. You can send a FF after each
  802.                  page or you can set the number of spaces between pages. 
  803.                  You can also print multiple copies and set you margins. 
  804.                  If the mail merge database is active you will also have the
  805.                  option to print form letters.)
  806.  
  807. <CS>C .......... Word count and document status. (Calculate the number of 
  808.                  words, the number of lines, the number of characters and the 
  809.                  number of pages in the entire document.)
  810.  
  811. <CS>A .......... Sort and alphabetize. (Descending Z-A or ascending A-Z. This
  812.                  option is fast and great for lists!)
  813.  
  814. <CS>CLR ........ Erase entire document. (You will first be prompted.)
  815.  
  816. <C>D ........... Show text macros. (You can program up to ten text macros for
  817.                  instant insertion at any time in your document. Hold down 
  818.                  ALTERNATE and any function key to program the string and hold
  819.                  down CONTROL and the same function key to insert the text 
  820.                  string into your document.)
  821.  
  822. <S>F9 .......... Load text macros from disk. (With this option you can load
  823.                  any set of ten macros you want. The configuration
  824.                  screen allows you to auto load macros when running dbWRITER.)
  825.  
  826. <S>F10 ......... Save macros to disk. (After programming some text macros you
  827.                  can save them to disk for another session. )
  828.  
  829. <CS>T .......... Switch transposed letters. (I'm always doing this, typing
  830.                  'thier' instead of 'their'.) 
  831.  
  832. <CS>H .......... Format text into columns. (For the time being you can only
  833.                  do two columns. I usually choose about 35 characters 
  834.                  across. You can also define the space between columns. 
  835.                  Each page will be separated by a FF printer control code. 
  836.                  Check your installed printer driver. Backup your document 
  837.                  before formatting it into columns. These 'psuedo' columns 
  838.                  cannot be individually edited after creation. Each line 
  839.                  of text is independant even though it contains two columns.)
  840.  
  841. <C>P ........... Set the page length. (Or click in the command line. The 
  842.                  default setting is 60 lines per page. This setting is 
  843.                  saved with your ruler line.)
  844.  
  845. <A>UNDO ........ Remove command line. (Hit ALT-UNDO or UNDO to re-install the
  846.                  command line. This feature is nice when reading long text
  847.                  files, it speeds up the scroll! While in this mode you can
  848.                  use the left mouse button to scroll your document down or 
  849.                  the right mouse button to scroll up.) 
  850.                   
  851. <A>A ........... Gives you access to desk accessories. (Make sure you close
  852.                  all opened accessories before returning to the edit screen.)
  853.  
  854. <C>Y ........... Clipboard. (You can click within the command line as well.
  855.                  If you choose to view clipboard contents use the arrow 
  856.                  keys to scroll around the clipboard window. The clipboard 
  857.                  can be used to copy text between two seperate documents.)
  858.  
  859. <A>T ........... Save and load ruler lines. (All TAB marks and margins can be
  860.                  saved or loaded from disk.  Also saves page length and word 
  861.                  wrap status. dbWRITER can be configured to automatically 
  862.                  load a ruler line when run.) 
  863.  
  864. <A>B ........... Display page breaks with a dotted horizontal line. (This 
  865.                  will be saved with your configuration.)
  866.  
  867. <C>INSERT ...... Insert special graphic characters. (Point and shoot, make 
  868.                  sure your printer can support these special characters.)
  869.  
  870. <A>C ........... Configure dbWRITER (Changes take effect next time you run the
  871.                  program. You can auto load the dictionary, the mail merge
  872.                  database, a custom ruler or custom macro set. The mail merge
  873.                  file must be named dbWRITER.MM, the ruler must be named
  874.                  dbWRITER.TAB and the macros must be named dbWRITER.MAC) The
  875.                  configuration file also contains information on screen
  876.                  colour, key click, horizontal scrolling, page breaks and
  877.                  other settings.) 
  878.  
  879. <C>C ........... Fixed or free cursor. 
  880.  
  881. <A>W ........... You can create custom printer drivers with this screen. (The
  882.                  printer driver named PRINTER.DBP is always default loaded
  883.                  when dbWRITER is run. You can also load another alternate
  884.                  driver and you can save the current driver. When no driver
  885.                  is present dbWRITER uses Epson FX mode. You can send a
  886.                  custom control code to the printer, choose the output device
  887.                  and decide how punctuation effects attributes. You can also
  888.                  set the margins just for printouts. Use UNDO or the
  889.                  right mouse to exit.)
  890.  
  891. <A>E ........... Erase all bold, underlined or italic codes. 
  892.  
  893. <A>F ........... Assign a custom keypress to the right mouse button. (This 
  894.                  will be saved with the configuration.)
  895.  
  896. <S>F5 .......... Delete all printer codes in the entire document.
  897.  
  898. <S>F4 .......... Imbed a FF character or forced end of page. (This separator 
  899.                  is shown as a triple bar, 80 columns across.)
  900.                  
  901. <S>F6 .......... Mail Merge Database. (This is a simple address book/cardfile
  902.                  that allows you to send form letters to anyone included 
  903.                  within the database.)
  904.  
  905.  
  906. In Closing
  907. ==========
  908. dbWRITER was originally written for my own use only. I am happy to share it
  909. with the rest of the ST community but please be patient with me. I will do my
  910. best to deal with bugs and updates in a timely fashion. I may not always be
  911. able to return a letter or electronic mail but I really do appreciate the
  912. feedback! Updates will be posted on all the major online services. I will try
  913. to enhance the limited documentation included with this version. I encourage
  914. those users creating printer drivers to upload them and share. dbWRITER is 
  915. NOT shareware, it is freeware and you do NOT have to pay to use it. Enjoy!
  916.  
  917.                                              David Becker
  918.                                              GEnie D.Becker8
  919.                                              Compuserve 73030,3562
  920.