Grammarian Version 1.5.1 by Dan Panke Total Register Users (as of 94-02-06): 4 ********************************************************************** Grammarian is POSTCARDWARE/LETTERWARE. If you use any of the files located in this archive you are required to send a postcard/letter to: Dan Panke 3559 Trappers Road, Gloucester, Ontario Canada K1T 2R1 Please include your name and return address on the postcard as well as the words: Grammarian 1.5.1 ********************************************************************** OVERVIEW Grammarian is a program designed to examine text files for word usage, spelling, and grammatical rules. Grammarian may not be right in everything it finds but it does present some good reminders. HOW TO USE GRAMMARIAN Use of Grammarian is simple. Place 'GRAMMAR.PRG' and 'GRAMMAR.INF' in the same path, and run 'GRAMMAR.PRG' in medium or high resolution. Choose the text file you wish Grammarian to check via the file selector then pick an OPTION for the Grammarian check. OPTIONS An Option can be selected by moving the inverse text bar with the UP or DOWN arrow keys and pressing RETURN when the desired Option is highlighted. The mouse can also be used to highlight the desired Option and a second click on the highlighted line will begin execution. CHECK TO SCREEN: All Grammarian display will be directed to your monitor. If Grammarian finds anything of interest in the file, the program will stop and display some text about the possible problem encountered. To continue with the check, press any key or click the mouse. You may also exit Grammarian at any point by pressing 'ESCAPE'. NON-STOP CHECK TO FILE (filename.CHK): As well as checking to the screen, this option creates a text file with the Grammarian check embedded in the file. The file will be created in the same path as the current file being checked but will have a file extender of 'CHK'. Be cautious if you use 'CHK' for file extenders as Grammarian makes no check for existing files and will overwrite them. As well, Grammarian makes no check for available disk space so make sure you have enough. The embedded text added to the 'filename.CHK' file will be enclosed between lines of number signs ([## - Grammarian error report - ##]). You may stop the Grammarian non-stop check by pressing 'ESCAPE'. CONFIRM CHECK TO FILE (filename.CHK): This option is very similar to the NON-STOP CHECK except you will be prompted by Grammarian to send or not send the error report to the CHK file. To have Grammarian send the error report to the CHK file, either press 'Y' (for YES) on the keyboard or click the LEFT mouse button. Anything else will NOT send the error report to the CHK file. EXIT [RETURN TO FILE SELECTOR]: Allows you to go back and reselect another file if you've made an incorrect choice. QUIT [END GRAMMARIAN]: Take a guess. THE 'GRAMMAR.TXT' FILE With a standard text editor or word processor that loads and saves in ASCII format you can edit or delete the grammatical checks. The format of the 'GRAMMAR.TXT' file is as follows: FIRST LINE - will be displayed when any grammatical error is found. ANY LINE BEGINNING WITH '>' - indicates a word or group of words to check for within your document. Added spaces may be appropriate to narrow the search field. (i.e. If you are wanting to find 'its' and you entered a line in 'GRAMMAR.TXT' of '>its', Grammarian would give you a warning at 'zits', 'itself', 'bitset', etc. To narrow the search, type an entry of '> its '.) A wild card '*' may be used to represent any letter of the alphabet in upper or lower case (a-Z). ANY LINE BEGINNING WITH '/' - is considered a comment line and will be ignored. However, the slash ('/') will not be ignored on the FIRST LINE (see above). TEXT LINES - these lines describe the grammatical error encountered and are displayed on the screen. View the 'GRAMMAR.TXT' file for a complete understanding of how the file is constructed. Once you're edited the 'GRAMMAR.TXT' file and saved it, run the 'COMPILE.PRG' and select the 'GRAMMAR.TXT' file via the File Selector. The Compiler will create your new 'GRAMMAR.INF' file. If you have any problems, suggestions or additions for Grammarian, please contact me on the following systems: GEnie: D.PANKE Delphi: DPANKE Internet: dpanke@proton.resudox.net Bullet BBS (613)731-2779 : SysOp UPDATES: Version 1.0.1 Added- Informed user to boot in medium or high resolution if incorrect resolution is used. Version 1.1.0 Added- Use of 'GRAMMAR.INF' file so users can enter their own checks. Version 1.2.0 Added- Colour for medium resolution. Removed- Checking of zero length lines. Added- Option to save a document to a text file (.CHK). Changed- Multiple printing of the same document line (unless more then one error is encountered in a single line). Version 1.3.0 Added- Stripped 'tabs' from input file for a more thorough search of file. Added- Wild card '*' for search strings. Added- More entries to the GRAMMAR.INF file. Fixed- A bug reported in the CHK files produced by Grammarian. (Thanks for reporting it, Bruno. BTW, where's your postcard/letter?) Added- Confirm CHK routine, so unwanted errors would not be added to the CHK file. Version 1.4.0 Added- The use of a slash ('/') to indicate a comment line. Added- More entries to the GRAMMAR.INF file. Added- Simple routine to make sure the Grammarian text would be displayed properly no matter what file is loaded. Fixed- A coding bug that occasionally gave an improper display of the error report. Version 1.5.0 Shortened code and added the compiler program to speed up execution of the checking process. Added- More entries in the GRAMMAR.INF file. Version 1.5.1 Fixed- Minor bug that hindered display of the first line of the error message. The program worked uncompiled but didn't when compiled. Added- More entries to the GRAMMAR.INF file.