home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / t / tt30002.zip / GG.ZIP / MANUAL.DOC
Text File  |  1993-01-06  |  15KB  |  439 lines
  1. THELMA THISTLEBLOSSOM Version 5.09 MANUAL.DOC
  2. Last revised: January 1993
  3.  
  4. Welcome to Thelma Thistleblossom, Grammar and Style Checker.
  5. Version 5.09
  6. Copyright 1993 
  7.  
  8. Timp Software
  9. 758 East 100 North
  10. Orem, Utah 84059-4910
  11.  
  12.  
  13. Table of Contents
  14. ~~~~~~~~~~~~~~~~~
  15. Table of Contents ............................................1 
  16. Introduction .................................................2
  17. Problem Display Screen....................................... 3
  18. System Requirements ..........................................4
  19. Install Program ..............................................4
  20. Running Thelma ...............................................5
  21. Editor Keys ..................................................6
  22. Backup Files .................................................7
  23. Commonly Asked Questions .....................................8
  24.  
  25.  
  26. Thelma Thistleblossom is a writing aid to help you create strong,
  27. readable, and concise documents.  When Thelma finds a potential
  28. problem, Thelma highlights the problem in context, defines the
  29. problem, suggests how to fix the problem, and lets you
  30. interactively change the text.
  31.  
  32.  
  33.  
  34. Thelma examines your document for such problems as: passive voice,
  35. long sentences, subject-verb agreement, possessive pronoun errors,
  36. cliches, punctuation errors, and spelling errors (based on an
  37. 85,000 word dictionary).  Thelma helps you write at the appropriate
  38. tone for your audience.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49. MANUAL.DOC page 1 of 9 THELMA THISTLEBLOSSOM Version 5.09 MANUAL.DOC
  50.  
  51. Introduction
  52. ~~~~~~~~~~~~
  53.  
  54. Use Thelma Thistleblossom to check and to correct WordPerfect or
  55. ASCII files.  Among other things, you may check for long sentences,
  56. passive voice, cliches, punctuation problems, padding, and
  57. consecutive prepositional phrases.  
  58.  
  59. You may instruct Thelma to skip a particular problem or to skip a
  60. general class of problems.  For example, Thelma finds padding
  61. problems such as the word "very."  When it finds "very," Thelma
  62. highlights it in context and gives you four choices.  If you
  63. choose:
  64. (1) Skip Once,      then Thelma continues.
  65. (2) Skip,           then Thelma won't display "very" any more in
  66.                     this file.
  67. (4) Edit,           then Thelma will let you edit the paragraph.
  68. (6) Skip Rule,      then Thelma won't display any "padding" in this
  69.                     file.
  70.  
  71. Preserving WordPerfect Codes
  72. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  73. The editor preserves all WordPerfect codes while you change your
  74. text.  Thelma always rechecks edited text.  Thelma draws
  75. WordPerfect codes that act as a blank space as smiley faces.  The
  76. editor won't let you delete them.
  77.  
  78. Formal versus Informal
  79. ~~~~~~~~~~~~~~~~~~~~~~
  80. Thelma begins with all rules working.  Try Thelma on several
  81. different files to get used to the rules it uses.  By turning off
  82. various rules, you can either make your document more formal or
  83. make your document more informal.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97. MANUAL.DOC page 2 of 9 THELMA THISTLEBLOSSOM Version 5.09 MANUAL.DOC
  98.  
  99. Problem Display Screen
  100. ~~~~~~~~~~~~~~~~~~~~~~
  101. The WordPerfect Speller and Thelma share similar screen displays.  
  102. When they find a problem, both programs highlight the problem in
  103. context, and place at the bottom of the screen a series of choices:
  104.  
  105.  
  106. 1 Skip Once 2 Skip 4 Edit 6 Skip Rule 9 Quit
  107.  
  108.  
  109. 1.  Skip Once.       Continue.  
  110. 2.  Skip.            Skip further displays of this problem.  
  111. 4. Edit.            Edit current paragraph.
  112. 6. Skip Rule.       Stop further displays of this general problem.
  113. 9. Quit.            Quit Thelma Thistleblossom.
  114.  
  115.  
  116. We've made it easy for you to choose "Skip Once": 
  117. 1.  press the number 1, or
  118. 2. press the Space bar, or
  119. 3. press the <Enter> key.
  120.  
  121.  
  122. When you choose the document, Thelma checks each sentence for
  123. errors in grammar, style, usage, capitalization, and punctuation.  
  124. When it finds a problem, Thelma:
  125. 1. highlights the problem,
  126. 2.  Gives a message describing the nature of the problem;
  127. 3.  Gives suggestions for fixing the problem;
  128. 4.  Displays actions similar to those of Wordperfect's speller.
  129.  
  130. You may accept one of the automated advice choices, or edit the
  131. problem, or control whether Thelma displays similar problems in the
  132. future.
  133.  
  134. To edit the problem, press 4.  Thelma places the cursor near the
  135. point where you need to begin editing.  After you finish editing,
  136. press the <Enter> key.  Thelma will re-check the sentence.
  137.  
  138. To choose one of Thelma's automatic choices, press the
  139. corresponding letter.  For example, when Thelma finds the word
  140. "agter" in a sentence, it'll suggest the replacements: 
  141. (a) after (b) alter (c) apter (d) aster.  
  142. Thelma will let you automatically replace the word.
  143.  
  144.  
  145. MANUAL.DOC page 3 of 9 THELMA THISTLEBLOSSOM Version 5.09 MANUAL.DOC
  146.  
  147. System Requirements
  148. ~~~~~~~~~~~~~~~~~~~
  149. Thelma Thistleblossom needs: DOS 3.0, 256 K RAM, a hard disk, and
  150. a floppy disk drive.  A color monitor is helpful.
  151.  
  152. Thelma Thistleblossom reads WordPerfect or ASCII files.  
  153.  
  154. WordPerfect 4.2
  155. ~~~~~~~~~~~~~~~
  156. You must use care, if you use Thelma with WordPerfect 4.2 files.  
  157. Thelma will display all the codes.  You mustn't delete or change
  158. any strange characters;  deleting or changing a strange character
  159. may prevent WordPerfect 4.2 from reading the file again.  You can
  160. use Wordperfect's <CTRL F5> to make the 4.2 file a generic file
  161. without 4.2 codes.
  162.  
  163. ASCII files
  164. ~~~~~~~~~~~
  165. You may use Thelma with any ASCII text file.  Thelma will display
  166. non-ASCII symbols as smiley faces.  Thelma doesn't permit you to
  167. delete these non-ASCII codes.  
  168.  
  169. Install program
  170. ~~~~~~~~~~~~~~~
  171. Thelma Thistleblossom is easy to install.  
  172.  
  173. 1.  Turn on the computer.
  174. 2.  Put disk #1 in the a: drive
  175. 3.  Type a:install
  176. 4.  Press the <Enter> key.
  177. 5.  When the install screen appears, follow the instructions.
  178. 6.  You must press the <Enter> key about six times to accept all
  179.      the default prompts.  (To save yourself hassle, let the
  180.      install program modify your autoexec.bat file.)
  181. 7.  Remove the disk and put it in a safe place.
  182. 8.  Type tt and press the <Enter> key.
  183.  
  184.  
  185. The install.exe program on disk #1 automatically:
  186. 1.  Creates the directory THELMA on the hard disk;  
  187. 2. Transfers the files to the directory THELMA;
  188. Install.exe will also update your AUTOEXEC.BAT by adding THELMA to
  189. your DOS PATH.  If you update your AUTOEXEC.BAT, then reboot your
  190. system by pressing the following three keys simultaneously:
  191. <CTRL><ALT><DEL>.
  192.  
  193. MANUAL.DOC page 4 of 9 THELMA THISTLEBLOSSOM Version 5.09 MANUAL.DOC
  194.  
  195. Running Thelma
  196. ~~~~~~~~~~~~~~
  197. Consider the following four different scenarios for running Thelma.
  198.  
  199. Note: Don't type the symbols <Enter>.  The symbol <Enter> tells you
  200. to press the <Enter> key.
  201.  
  202.  
  203. 1. You want to check a file in the directory \wp\march, but you
  204. can't remember its name.  Type:
  205.  
  206. tt      <Enter>
  207.  
  208.  
  209. When the current directory appears, change the prompt to the
  210. directory you want to examine.  In this case, change the prompt to
  211. read \wp\march\*.*.  After the program displays the files, use the
  212. down arrow key to move to the file you want to check.  Press the
  213. <Enter> key.
  214.  
  215.  
  216.  
  217. 2. You're in WordPerfect.  You're typing the file john.rpt in the
  218. directory \wp\student\paper.  You decide to check it for grammar
  219. and style.  Press the function key F7 to exit WordPerfect.  Type: 
  220.  
  221.  
  222. tt john.rpt    <Enter> 
  223.  
  224.  
  225.  
  226. 3. You've turned on the computer.  You decide to check the
  227. WordPerfect file john.rpt in the directory \wp\student\paper.  
  228. Type:
  229.  
  230. cd \wp\student\paper     <Enter>
  231.  
  232. to change to the \wp\student\paper directory.  Then type: 
  233.  
  234. tt john.rpt         <Enter>
  235.  
  236.  
  237. 4. You've turned on the computer.  You decide to check the
  238. WordPerfect file john.rpt in the directory \wp\student\paper.  
  239. Type:
  240.  
  241.  
  242. tt \wp\student\paper\john.rpt      <Enter>
  243.  
  244. MANUAL.DOC page 5 of 9 THELMA THISTLEBLOSSOM Version 5.09 MANUAL.DOC
  245.  
  246. Editor Keys
  247. ~~~~~~~~~~~
  248.  
  249. Thelma Thistleblossom and the WordPerfect Speller share similar
  250. editor keys.
  251.  
  252. Press the left arrow key (<--) to move to the left.
  253.  
  254.  
  255. Press the right arrow key (-->) to move to the right.
  256.  
  257.  
  258. Press the CTRL key and left arrow key to move left one word.
  259.  
  260.  
  261. Press the CTRL key and right arrow key to move right one word.
  262.  
  263.  
  264. Press the Delete key to delete under the cursor.
  265.  
  266.  
  267. Press the Backspace key to delete to the left of the cursor.
  268.  
  269.  
  270. Press the <Enter> key to leave the editor.
  271.  
  272.  
  273. What Thelma Does
  274. ~~~~~~~~~~~~~~~~
  275. Thelma Thistleblossom catches grammar, style and mechanical
  276. problems.
  277.  
  278. Thelma catches such grammar problems as: article agreement (an
  279. noun, a empty bucket) subject verb agreement (I talks), split
  280. infinitives (to loudly shout), and prepositions at the end of a
  281. sentence.
  282.  
  283. Thelma catches such mechanical problems as: capitalization errors
  284. (john, boston), ellipses, interchanged punctuation marks, incorrect
  285. sentence punctuation, spelling errors (based on an 85,000 word
  286. dictionary).  
  287.  
  288. Thelma catches such style problems as: abbreviation errors, archaic
  289. words, cliches, words with derogatory associations, passive voice,
  290. long sentences, wordiness, redundancies.
  291.  
  292. MANUAL.DOC page 6 of 9  THELMA THISTLEBLOSSOM Version 5.09 MANUAL.DOC
  293.  
  294. Backup Files
  295. ~~~~~~~~~~~~
  296. Thelma Thistleblossom always makes a backup copy of your original
  297. file by adding .ttb to the original file name.  It makes the backup
  298. copy before it makes any changes.  You may use the backup copy to
  299. return to the original document.  Always make a backup of ANY
  300. critical document.  
  301.  
  302. Thelma won't let you correct a .ttb file (otherwise the backup
  303. would have the same name as the original).
  304.  
  305. Suppose you run Thelma on the file john.rpt.  After applying
  306. Thelma, your directory will contain both john.rpt and john.ttb.  
  307. John.rpt is the file that contains the edited text.  John.ttb is
  308. the name of your original, unchanged (backup) file.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340. MANUAL.DOC page 7 of 9 THELMA THISTLEBLOSSOM Version 5.09 MANUAL.DOC
  341.  
  342. Commonly Asked Questions
  343.  
  344. ? -- Do I run Thelma from WordPerfect?  
  345. A -- No!  Recall how you run WordPerfect.  
  346.      a. You type cd \wp and press the <Enter> key from the DOS
  347.      prompt to change to the directory that holds the WordPerfect
  348.      program wp.exe.
  349.      b. You type wp and press the <Enter> key.
  350.      c. You call up your document using F5.
  351.      d. You work on writing your document.
  352. It's the same for Thelma Thistleblossom.
  353.      a. You type cd \thelma and press the <Enter> key from the DOS
  354.      prompt to change to the directory that holds the program
  355.      tt.exe.
  356.      b. You type tt and press the <Enter> key.
  357.      c. You call up your document.
  358.      d. You work on correcting your document.
  359.  
  360. ? -- Why does Thelma recognize a semi-colon (;) as a sentence?
  361. A -- Thelma treats what comes before the semi-colon as an
  362. independent sentence (requiring a noun and a verb).  Consequently,
  363. it considers the punctuation at the end of this sentence as a
  364. stopping point.  Thelma knows that after a semi-colon, a word
  365. doesn't have to begin with a capital letter.  Thelma does suggest
  366. that you provide two spaces after the semi-colon.
  367.  
  368. ? -- Why does Thelma sometimes tell the user to capitalize the
  369. first word following an ellipsis?
  370. A -- You form an ellipsis by three equally spaced periods . . .
  371. Usually, Thelma treats an ellipsis as marking the end of a
  372. sentence.  Therefore, it checks that the next sentence (in this
  373. case, the first word following the ellipsis) begins with a capital
  374. letter.  
  375.  
  376.  
  377. ? -- Why can't I use the up arrow key in the editor?
  378. A -- Thelma works like the WordPerfect speller.  The WordPerfect
  379. speller doesn't let you use the up arrow or down arrow keys either.  
  380. In Thelma, you may only examine the text that's on the screen.  If
  381. you need to do serious editing, underlining, bolding, or moving
  382. paragraphs, then use WordPerfect or your word processor.
  383.  
  384. ? -- Why does this file include instructions for installing Thelma?
  385. A -- If you lose the directions given with the shipping materials,
  386. then you can print this file, and create your own hard copy.
  387.  
  388.  
  389. MANUAL.DOC page 8 of 9 THELMA THISTLEBLOSSOM Version 5.09 MANUAL.DOC
  390.  
  391. ? -- What is the difference between the original file, and the new
  392. file with the .ttb extension?
  393. A -- Say that you decide to run Thelma on your file named john.wp. 
  394. When you make your corrections, Thelma saves the original file as
  395. john.ttb.  The .ttb file is a backup file, like Wordperfect's .bak
  396. files.  
  397.  
  398. ? -- Why does Thelma warn about overwriting the .ttb file?
  399. A -- Suppose that you decide to correct john.wp a second time.  If
  400. you overwrite the old .ttb backup, then you won't have a copy of
  401. the original document with which you started working.  Instead, the
  402. .ttb file will be a copy of your first set of changes.
  403.  
  404. ? -- Why does Thelma sometimes think that headings or items in a
  405. list are sentences needing periods and that I should capitalize the
  406. first letter of the next line?
  407. A -- Thelma treats a WordPerfect hard return as the end of a
  408. paragraph (therefore, the end of a sentence).  WordPerfect creates
  409. a hard return whenever you press the <Enter> key.
  410.  
  411. ? -- Why does Thelma flag both informal and formal problems?
  412. A -- Thelma doesn't know whether you want to make your document
  413. more formal or more informal.  Consequently, it displays both types
  414. of usage.  If you want to make your document more formal, then
  415. whenever an informal rule appears, press 6 to turn off the informal
  416. rule.  On the other hand, if you want to make your document more
  417. informal, then whenever a formal warning appears, press 6 to turn
  418. off the formal rule.  Until you're comfortable with the prompts, we
  419. suggest that you leave on all rules.
  420.  
  421. ? -- How do I interpret the angle bracket <  > symbols in this
  422. documentation?
  423. A -- When we ask you to press keys that aren't regular numbers or
  424. letters, we enclose the name of the key in angle brackets, such as
  425. <Enter> for the enter key.  Don't type the brackets.
  426.  
  427. ? -- Must I run Thelma again after I edit the text?
  428. A -- No.  Thelma automatically re-analyzes your sentences after
  429. each change.  
  430.  
  431. ? -- Does Thelma Thistleblossom make mistakes?
  432. A -- Yes!  Context, jargon, elliptical style, misspellings,
  433. dialect, technical documents, and unusual style may cause Thelma to
  434. make errors.  Furthermore, Thelma doesn't find all types of errors.  
  435. Thelma does point out possible errors and weaknesses.  Thelma
  436. suggests possible solutions.  You decide what recommendations to
  437. accept.  
  438.  
  439. MANUAL.DOC page 9 of 9