ClipWord (TM) & SpellClip (TM) The Word Processor and Spelling Checker for Clipper Developer's Applications. From Action Plus Software The Information Management Company ClipWord includes . . . Clipper Source Code Sample Demo Program Bold Face Underlining Field Merging Margin Settings Import & Export Uses MemoEdit On-Screen Template Easy User Interface SpellClip includes . . . Source Code WordPerfect-like User Interface Built-In Dictionary - 24,000+ Words Add Words on-the-fly Highlights Offending Words Edit Offending Words WildCard Look-Ups Build your own Dictionaries with supplied parsing routine ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º Companion Products º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º ClipWord Price: $99.95 º º SpellClip Price: $99.95 º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ Quick Start Instructions Welcome to ClipWord / SpellClip, the word processor and spelling checker for Clipper(R) applications. Please follow the next few instructions to get started with this new program. 1st: Make sure that you back up your master distribution diskettes. 2nd: Copy the contents of the distribution disk to a new sub-directory on your hard disk. (You can call it whatever you like.) 3rd: Run the SPELLCLP.EXE file. It is a self-unarchiving utility that will decompress the necessary files for your use. This file was compressed using PKZIP. 4th: Type COMPILE [Enter]. This will create a standalone SAMPLE.EXE program using SAMPLE.PRG and SPELLCLP.PRG. You may wish to review the contents of the COMPILE.BAT file to modify it to use another linker. It assumes that you will be using TLINK and that your Clipper libraries are located in C:\TOOLS\. This obviously may not be the case so modify the file to fit your circumstances. After the program is compiled, the new SAMPLE.EXE program will be automatically loaded for you. You should first select the INDEX DICTIONARY option on the menu because the DICTIONARY index files are not shipped with the program. They must be created before you attempt to use the spelling checker. WARRANTY Action Plus Software warrants that the original diskettes are free from defects in material and workmanship, assuming normal use, for a period of ninety (90) days from the date of purchase. If a defect occurs during this period, you may return your faulty diskette to Action Plus Software, along with a dated proof of purchase, where it will be replaced free of charge. NOTICE Action Plus Software make no representations or warranties, express or implied, with respect to ClipWord / SpellClip, or this manual including but not limited to warranties of merchantability or fitness for a particular purpose. Action Plus Software reserve unto themselves the right to make periodic changes, revisions, enhancements and alterations of any kind to ClipWord / SpellClip and or its manual without obligation to notify any person, institution or organization of such changes, revisions, enhancements and alterations to the product. The program is provided "as is" without warranty of any kind, either expressed or implied, including, but not limited to the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the program is with you. Should the program prove defective, you (and not Action Plus Software) assume the entire cost of all necessary servicing, repair or correction. Action Plus Software does not warrant that the functions contained in the program will meet your requirements or that the operation of the program will be uninterrupted or error free. Copy Protection ClipWord / SpellClip is not copy protected. You may make backup copies of this software. This software is sold to be used on a single computer. Please do not abuse the trust we place in you by providing this software to you in an unprotected form. You may move this software from one computer to another as long as you cannot use it on two machines at the same time. Should you decide to make it possible to use this software on more than one machine at a time you would be breaking the law. It is not legal to give a copy of this software SOURCE CODE to another person. You have purchased the right to use the software, you did not purchase the rights of authorship or distributorship OF SOURCE CODE. Please act accordingly. You are authorized to give or sell copies of your COMPILED ORIGINAL APPLICATIONS that include this compiled source code to others. License You should read the terms and conditions of this License Agreement before you use the software. Your use of the software constitutes your full and complete acceptance of the terms and conditions of this License Agreement. If you do not agree to abide by the terms of this License Agreement you should immediately return the unopened software to Action Plus Software, and your purchase price will be refunded. The purchaser assumes the responsibility for choosing this software program to achieve the results that they desire. This includes the installation, use and results they achieve from the use of the software program. This License Agreement grants you a non-exclusive license to use this software and permits you to legally do the following things: 1. Use this software program on one computer at a time as a book is used. If this program is to be used by more than one person at one time, each individual using the software must have an original copy of the software. 2. Make archival backup copies of the contents of the diskettes for the sole purpose of protecting the users original copy from loss. 3. Transfer the program and this license to an other party if the other party agrees to accept the terms and conditions of this Agreement. If you transfer the program, you must at the same time either transfer all copies whether in printed or machine-readable form to the same party or destroy any copies not transferred. You may not use, copy, modify, or transfer the program except when you comply with the terms of this license agreement. 4. Include the source code contained in SPELLCLIP.PRG and SAMPLE.PRG and the dictionary file DICT.DBF in any Clipper or other COMPILED program or programs and distribute said program(s) royalty free. All compiled programs must contain the copyright notice. The prices for the programs are as follows: ClipWord SpellClip $99.95 $99.95 ClipWord The following are a set of procedures and functions that allow a memo field to be edited with some of the common word processing functionallity. All rights to this software are reserved to ACTION PLUS SOFTWARE. Use of this code is limited to those things specifically agreed to in the License Agreement. (C)Copyright ACTION PLUS SOFTWARE 1988,1989,1990 All Rights Reserved - 11485 S. High Mountain Drive SANDY,UT 84092-5675 - (801)572-3303 Files contained on the distribution disk README.1ST Errata file containing the latest information about the program. SPELLCLP.PRG The ClipWord & SpellClip source code program files. SAMPLE.PRG The program source file that demonstrates how you will integrate SPELLCLP.PRG into your own applications. DICT.DBF The SpellClip Dictionary Database COMPILE.BAT A simple batch file that will create a standalone word processing program with all the functionality of ClipWord and SpellClip. MAKEDICT.EXE A standalone program that will permit you to create your own custom dictionaries or add to DICT.DBF by "feeding" MAKEDICT.EXE text files from which it will parse unique words. This utility will also generate a frequency of usage counter for each word to indicate which words are most commonly used and should therefore be placed at the top of the DICT.DBF file for inclusion in the quick find array. MDICT.DBF The temporary database used by MAKEDICT.EXE which includes the counter field not used in DICT.DBF SPELLCLP.TXT This file. Scope and purpose of the Program The purpose of these programs is to provide Clipper programmers will an easy-to-integrate, powerful word processor for their Clipper applications. ClipWord contains functions to Add, Edit, Print, Import, Export, and Save documents. Within these documents BOLD, UNDERLINE, Spell Checking, Block operations, Field Merging, and Margin settings are supported. Document length is limited by available memory because of the nature of the memo fields in Clipper. We recommend the use of BLINKER to increase the available memory in your finished application. We have been able to enter documents up to 24,000 characters in Action Plus, a very large application. We appreciate your interest in our products and welcome your suggestions. PROCEDURE PRINTLET Prints the memo field using bold underline and merged fields Please check for printer avaliablity and avaliabliity of the variables to be used in the merge fields. Parameters are: LETTER: memo field or memory variable to be printed LETLINES: The lines to leave at the top of the page for letter head. MPRINTER: Logical .t. if HP laser .f. for epson codes The following are variables which must be defined before calling this procedure: RIGHT: Right margin in spaces LEFT: Left margin in spaces MRGNAMES: Array containing the names of the fields used in the merge when the memo field is edited. This is a character array which has the word[s] between the merge blocks chr(176). Example:mrgnames[1]='First Name' REALNAMES: Array containing the real values to substitute when the merge field is found. This is used as a macro and may contain any valid database variable, memory variable or expression. The evaluation of an array element must be character. Example:realnames[1]='trim(first)' FUNCTION MKLN Prepares one line for printing. FUNCTION FIXL Adds underline and bold face codes to line after format FUNCTION MKLTR Creates letter including merged information from variable letter FUNCTION MRGFLD Finds the proper field to merge parameters are: b beginning block position e ending block position FUNCTION MAIL This is the main routine for processing a memo field or memory variable. parameters are: LETTER: variable containing the letter to be edited. AVAIL: Which functions are avaliable. This is a character variable which contains a list of 1's and 0's indicating which functions can be used in this process. The functions in order are: Help - F1 Spell - F2 Block - F3 DOS - F4 (Not used in this program but recommended. Use Dr. Switch to implement this for yourself. (Call 212 787-6633 ) Files - F5 Bold - F6 Underline - F7 Margins - F8 Merge - F9 Example:avail='110100011' help, spell,dos,margins,merge will be made available. Program Variables Needed Four variables need to be defined before calling this program. They are: RIGHT LEFT The variables contain the right and left margins in spaces. MRGNAMES The name of an array which contains the names you want to use for merging information into your letter. This array will be used to select variables to merge into the letter. It is associated with realnames which contains an expression which when evaluated will be the actual value to include in the letter. Example: mrgnames[1]='First' mrgnames[2]='Middle' mrgnames[3]='Last' mrgnames[4]="Today's Date" mrgnames[5]='Total Sale' The reason for using MRGNAMES and REALNAMES is to permit you to display meaningful field names to your users to select from for the field merge operations. Sometimes the field names used by programmers don't make sense to non-programmers. This strategy makes the interface more intuitive, regardless of the actual field names used. REALNAMES The name of an array which contains an expression which when evaluated will give the value associated with the same element of mrgnames. Example: realnames[1]='trim(first)' realnames[2]='middle' realnames[3]='trim(last)' realnames[4]='dtoc(date())' realnames[5]='str(tot_sale,7,2)' FUNCTION KEY SETTINGS: In our applications we always use F1 set to help and F4 set to shell out to DOS. The other keys must be set to their normal values that is f2=-1, f3=-2, f5=-4, f6=-5, f7=-6, f8=-7, f9=-8. In addition F10 is set to chr(23) so that it is used to save and exit the memoedit function. FUNCTION CHKFILE When EXPORTING with the [F5] FILES option it is necessary to determine if a file with the same name exists and if so to permit overwriting or to ask for another name. FUNCTION CHKFILE performs these functions. PROCEDURE ENDBLOCK Completes the blocking procedure according to input to blktype. The BLOCK OPERATION TYPES are indicated below: Move Copy Delete Export FUNCTION BEDITLET Displays the row and column on the bottom of the screen. Handles the 10 function key calls. FUNCTION EDITLET Displays the row and column on the bottom of the screen. Handles the 10 function key calls. PROCEDURE CENTERON Centers on a column PROCEDURE SETMARGIN Sets margins You may set margins with a total width of up to 65 characters. Right margins may be from 0-50, Left margins may be 10 to 70. PROCEDURE MRG Place merge marks in document from selection information SpellClip PROCEDURE SPELLCHECK Checks a memo for spelling errors PROCEDURE CHKWORD Checks spelling of word. When an offending word is encountered by the spelling checker the following options are provided. Functions are organized like WordPerfect's Spelling Checker. Skip: Permits the user to leave the offending word as is. Skip All: Permits the user to leave this offending word and all future occurences of the offending word in the current document. Add: Permits the user to ADD the offending word to the user’s dictionary (DICT.DBT). Edit: Permits the user to enter the document at the position of the offending word to make any changes they wish. [F10] returns them to the spell checking routine. Look Up: Permits the user to enter a word pattern to search for, including wildcards. PROCEDURE REPLACEWORD Replaces the offending word with the replacement word PROCEDURE EDITWORD Edit at offending word [F10] Permits the user to Accept Changes [Esc] Permits the user to Abandon Changes FUNCTION SPELLEDIT Edit spelling checker This routine also displays the INSERT/TYPEOVER mode at the bottom of the screen. TYPE OVER INSERT PROCEDURE DISPWORD Displays the offending word. PROCEDURE MAKEBOX Makes box with shadow FUNCTION CHKWILD Checks a string against another string to see if it matches using wild cards. Str1 contains the wild cards PROCEDURE LOOKUPW Looks up possible word combinations Enter the word pattern including wild cards (*,?): PROCEDURE FLIMPORT Import a file Permits the user to enter a file name to be imported into the current memo field. The routine alternatively permits the user to press [=] to display a directory path, whereupon the program will display all file names in an alphabetical scrolling selection list to pick from. It is recommended that you indicate in your on-line HELP that users should only attempt to IMPORT DOS TEXT files. If importing WordPerfect files they should first be saved as DOS TEXT files after setting the left and right margins at 1.25" using COURIER 10 point font. This applies to WordPerfect 5.0 and 5.1. WordPerfect 4.2 users will want to leave margins at 10 and 74 to provide for a 65 character line width. This will eliminate any extra re-formatting of the document after it is imported. PROCEDURE LETSCR Creates background screen for letters with function keys available on the left. REPLACEMENTS FOR FUNCKY FUNCTIONS The following are functions written to emulate Funcky functions which are used in Action Plus. If you will be compiling using Funcky you should delete these functions first.