Source Code 1992 March

home *** CD-ROM | disk | FTP | other *** search

/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / msdos / txtutl / cspella.arc / CSPELLA.DOC next >

Wrap

Text File | 1987-12-15 | 15.4 KB | 332 lines

COPYRIGHT(C) 1987 PETER A. BANKS The copyright of this program is retained by its author. It may be freely distributed. It may neither be sold for profit nor included in a sold software package without permission of the author. DESCRIPTION "CSPELLA" is a spelling checker program written in Turbo C V1 for IBM PC and clones. There is also a version for Digital Equipment Corporation's Rainbow. Cspella marks words not found in it's internal dictionaries with a special mark character. Ascii text editors can later be used to search for this mark character to do spelling correction at a later time. The internal dictionaries in Cspella have almost 16,000 basic words. Due to the suffix-handling capacity of "CSPELLA", in effect, the dictionaries may contain up to 48,000 words. In addition, "CSPELLA" supports a short user dictionary of up to 1000 words. "CSPELLA", while standing in the tradition of previous "SPELLA" programs, is radically improved. For ease of use and speed, there is no longer a separate standard dictionary file. The executable program including the integrated dictionary occupies 45% less disk space. Program design is greatly simplified, resulting in increased speed. Due to the elimination of the separate standard dictionary file, disk accesses are drastically reduced, resulting in even greater speed. The program can spell a 10k byte document in about 2 seconds on an 8mhz AT clone. The Rainbow Version does the 10k byte document in about 11 seconds. The earlier Turbo Pascal versions did the same 10K byte document in 20 seconds for the AT CLONE and 100 seconds for the Rainbow. This is an increase in speed of 9 to 10 times. The New Version in C supports three new switches. -V displays text as it is spelled. The -D switch is used to dump the dictionary. The -M allows the user to specify what mark character is used to label mispelled words.The Command line parser was also modified to allow for Unix Compatibility should the program ever be ported over to Unix. INSTALLATION In the MSDOS operating system, use the following commands to copy "CSPELLA" into the desired directory. E:>COPY A:CSPELLA.EXE E:\speldir\CSPELLA.EXE Edit autoexec.bat. Enter the following lines if they are not already present. The "PATH" statement tells the operating system where to look for the program. This enables you to run "CSPELLA" from anywhere on the system. The "SET CSPELLA" statement tells the operating system where to look for the personal dictionaries. PATH E:\speldir\; The CSPELLA command line is CSPELLA <FILENAME> <USERDIC> -V -D -N -M? -V enable Video display of text -D dumps all of the dictionaries to Video Screen -M allows user to define mark character -N WARNING DO NOT USE WITH SEDT OR PTP. LOSS OF DATA WILL RESULT -N Is used for WORDSTAR Compatitibility Only. Switches can be place before or after the file names Source Document must be listed before the optional Personal Dictionary Please hit any key to continue___ After the user hits the key the following screen appears Enter document to be spelled [Default exit] ________________________________________________________________ If the user entered the filename from the MSDOS System Prompt, Cspella writes the filename on the dotted line. Otherwise, Cspella prompts the user to enter it now. If the program cannot locate the file, it will give an error message and ask the user to enter the filename again. The program will loop in this cycle until it gets a valid file name or a null string (just a carriage-return.) If it gets a null string, the program will exit to the operating system. Full MSDOS pathing is supported. Assuming that a valid file name for the source file has been entered, "CSPELLA" will now display the following line. Enter the personal dictionary [Default none] _________________________________________________________________ If the user entered the filename of the personal dictionary from the MSDOS System Prompt, the filename is written on the dotted line. Otherwise, he is prompted to now enter it now. The program assumes that if pathing information is not included in the file name then the file is in the logged directory, or in the directory set by the logical "CSPELLA" in autoexec.bat. If the program cannot open the user-dictionary, it will give an error message and ask the user to enter the filename again. The program will loop in this cycle until it gets a valid file name or a null string (just a carriage-return.) If it gets a null string, the program will assume that there is no personal dictionary to be used. "CSPELLA" will now go off and mark errors, scrolling the text on the screen as it processes it. Errors in the text will be displayed at bottom of screen . The program will gracefully exit back to the operating system if any key is pressed while it spells the document. When "CSPELLA" is done it will write to the screen the total number of words and the total number of errors. The program will now display the following line. Do you wish to save the input file?[Default no]___ If the user enters "y" or "Y", "CSPELLA" will save the input as a .B$K file. Otherwise, by default, the input file will not be saved. If no personal dictionary was specified and there are spelling errors in the text, "CSPELLA" will now prompt to see if the user wishes to create a personal dictionary. If the answer is "N", Spella is finished its task. If the user answers "Y", the name of the personal dictionary must be entered. Unless specific pathing information is included in the filename, the personal dictionary will be placed in the directory declared in the environment statement in AUTOEXEC.BAT. If that file already exists, the user will be asked if he/she wishes to overwrite the existing personal dictionary. If the answer is "N" Spella will end its work without creating a new personal dictionary. If the user answers "Y" the existing dictionary will be over written. Each word marked as an error is now displayed. The user is then asked if he/she wishes to add each specific word to the personal dictionary. If the answer is "Y" or "y" then the word is added. If a personal dictionary was specified at the beginning of the program and there were spelling errors, the user is asked if he/she wishes to add any of the words. If the user answers anything but "Y" or "y" the program will conclude. Otherwise each word marked as an error is displayed. The user is then asked if he/she wishes to add each specific word to the personal dictionary. If the answer is "Y" or "y" then the word is added. "CSPELLA" is now done. If "CSPELLA" was called from an editor the user is now returned to that program. If "CSPELLA" was called from the MSDOS System prompt, it returns to the operating system in the directory from which it was called. The marked file may now be edited. -N OPTION The -N Option for Wordstar compatibility is only available from the command line. WARNING!! DO NOT USE THE -N OPTION WITH SEDT. THE NULL CHARACTER WILL CAUSE A FATAL CONDITION IN SEDT RESULTING IN LOSS OF LARGE BLOCKS OF TEXT. To use Wordstar to search for the null characters, press <CONTROL-L>. "CSPELLA" cannot be called automatically from Wordstar. Use stand alone mode. LIMITATIONS "CSPELLA" will not process words bigger than 20 characters. Nor will it process words of less than 3 characters. Therefore the user must assume responsibility for checking these types of words. "CSPELLA" does not check the appropriateness of suffixes added to words but merely strips them to see if they were added according to the general rules of spelling. Example, "CSPELLA" would treat "lioned" as valid word. This is not usually a problem, since most spelling errors are of words we know the proper forms of. WHERE TO GET "CSPELLA" DIGITAL EQUIPMENT CORP. EMPLOYEES with system accounts on the "ENET" may obtain "CSPELLA" executables by copying "CSPELLA.ARC" from LEXREX::CSPELLA$CLONE:*.* for the IBM version LEXREX::CSPELLA$RBW:*.* for the DEC Rainbow version WARRANTY AND WHERE TO REPORT BUGS OR SUGGESTIONS Since I am not charging anything for "CSPELLA" I will not guarantee the product. However if you really like "CSPELLA" you may feel free to offer my wife and I a free trip to Hawaii. If you live in the Northwest, offer me a new job as a Software/Hardware Professional. (Doesn't hurt to ask!) Seriously though, feel free to contact me with "bug" reports or suggestions, before 10:00 PM Eastern Standard Time at: Peter A. Banks 32-6 Briarwood Lane Marlborough ,Ma 01752 Work Telephone:1-617-568-4855 (DTN 225-4855) ENET:RETORT::BANKS HOME PHONE: 617-481-8242 PROGRAM FLOW OF "CSPELLA" Initialize VALUES get file name etc. Loop1 Read in processable line Loop2 PARSE OUT TO A WORD if word |-------< first lookup in internal dictionaries. | |-------< If not in dictionaries strip suffix look up again | in internal dictionaries. |if word |-------< If still not found binary search the personal | dictionary. | Write to heap string is not a word. | |-------> PROCESS RESULTS if not word write mark character and output entry. LOOP2 until END of line if EOL output corrected line to output file Loop1 until EOF(input) close files save input file ? if not delete input file if yes rename input file If personal dictionary used add desired words to personal dictionary If Personal dictionary not used create a personal dictionary and add desired words to the personal dictionary END OF PROGRAM SEDT Description Sedt is a screen editor written with the goal of providing a common editor across a wide range of operating systems. For ease of use, Sedt is programmed with a keyboard layout similar to EDT (The Digital Equipment Corp Vax-VMS Editor or PDP-11 KED). Distribution Policy of Sedt Sedt binaries for VMS and Rainbow-100 are being made available for customers and Digital internal use on the condition that the original copyright is not violated or removed, that no modifications are made to the program without the express permission of the author Anker Berg-Sonne. There is a development version of Sedt that supports the IBM PC family, which is not available publicly out side of Digital Equipment Corp. This policy may well change in the future. How to use Cspella with SEDT "SEDT" can be modified to call "CSPELLA". To do so the user needs at least 380K bytes of memory. Using SEDT on a system with 380K bytes of memory, the largest document "CSPELLA" can handle is about 60K bytes in size. In stand-alone mode "CSPELLA" is not limited by the length of the document. If you wish to shell out of SEDT to "CSPELLA" and back again at the press of a key, you MUST modify the key configuration file. The modification could be done as in the example below. In this example, a GOLD <CONTROL-S> will call "CSPELLA". The filename of the document edited will be passed to "CSPELLA". When "CSPELLA" is done spelling the document SEDT then loads the marked file, which the user may now edit. The <CONTROL-S> will find the words marked as errors, deleting the marker character <144>. The <144> CHARACTER (ASCII #144) is entered by pressing [GOLD]144[GOLD][KEYPAD3]. "EDT" EXAMPLE A018....... A019(@F~<144>~:D+@C). ;CONTROL-S SEARCHES FOR<144> AND DELETES THE <144> A020..... . . GA018....... GA019:FS~~:SYS~CSPELLA %F~:FE~%F~. ;GOLD CONTROL-S CALLS CSPELLA GA020.... OH Yeah Trademarks MSDOS (TM) Micro-SOFT Corp. SEDT COPYRIGHT (C) DIGITAL EQUIPMENT CORP. Turbo C (TM) Borland International. WORDSTAR (TM) MicroPro International Corp.