---------------------------------------------------------------------- WHAT IS IN THIS READ.ME FILE? ---------------------------------------------------------------------- This READ.ME document includes the following sections: * Patching FoxPro From CompuServe * What's New * When to Patch * How to Use Patch * Patch Messages * Baselines * Additional Files * CAUTIONS ---------------------------------------------------------------------- PATCHING FOXPRO FROM COMPUSERVE ---------------------------------------------------------------------- The PATCH.EXE utility is an application that is used to install upgrades to FoxPro, the optional FoxPro Distribution Kit, and help files. To use the PATCH utility, simply download the PATCH.EXE and PATCH.DBF files into the FoxPro directory, then apply the patches to the FoxPro files following the steps in the section HOW TO USE PATCH. The PATCH.DBF database contains information about the latest FoxPro versions. Since PATCH.DBF is small (usually less than 10K), you can frequently download PATCH.DBF and run PATCH.EXE to see whether you have the most current FoxPro files. PATCH.EXE will upgrade the following files: FOXPRO.EXE Single-User Standard FoxPro FOXPRO.OVL Single-User Standard FoxPro FOXPROX.EXE Single-User Extended FoxPro FOXPROL.EXE Multi-User Standard FoxPro FOXPROL.OVL Multi-User Standard FoxPro FOXPROLX.EXE Multi-User Extended FoxPro FOXHELP.DBF FoxPro help file (database file) FOXHELP.FPT FoxPro help file (memo file) FOXPRO.ESL Distribution Kit Standard Support Library FOXPRO.ESO Distribution Kit Standard Support Library FOXPROX.ESL Distribution Kit Extended Support Library FOXPRO.LIB Distribution Kit Standard Executable Library FOXPROS.LIB Distribution Kit Standard Executable Library FOXPROX.LIB Distribution Kit Extended Executable Library FOXPROSX.LIB Distribution Kit Extended Executable Library FOXCLIBM.LIB Distribution Kit Standard Executable Library FOXCLIBR.LIB Distribution Kit Extended Executable Library ---------------------------------------------------------------------- WHAT'S NEW ---------------------------------------------------------------------- As of 9/18/91, a new, easier-to-use version of the PATCH utility is available. Download the current versions of PATCH.EXE and PATCH.DBF before patching FoxPro files. Patch files themselves have an .FPF extension. To find out about other files included with the PATCH disks, see the ADDITIONAL FILES section later in this document. -------- NOTE PATCH.EXE is occassionally updated. -------- When it is, you will be notified. Several sets of patch files are available to upgrade FoxPro, the optional FoxPro Distribution Kit and help files. When you patch and use the -v (verify) switch, the PATCH utility will generate a list of files you need to download. One of the following sets of patch files will be included in the generated list: * BASE1 - July 12, 1991 * BASE2 - July 19, 1991 * BASE3 - September 26, 1991 * BASE4 - October 7, 1991 * BASE5 - November 15, 1991 * BASE6 - March 25, 1992 * BASE7 - May 20, 1992 * BASE8 - June 3, 1992 HELP FILE NOTE - For FoxPro versions dated October 7, two patch versions of the help file exist. If your October 7 version of FoxPro was installed from the original disks, use the HELP4B patch file. If your October 7 version of FoxPro was created by using a patch, use the HELP4A patch file. HELP FILE NOTE - For FoxPro versions dated November 15, two patch versions of the help file exist. If your November 15 version of FoxPro was installed from the original disks, use the HELP5B patch file. If your November 15 version of FoxPro was created by using a patch, use the HELP5A patch file. Fox recommends that you keep your original disk version of FoxPro in a separate directory, as suggested in the BASELINES section later in this document. ---------------------------------------------------------------------- WHEN TO PATCH ---------------------------------------------------------------------- You may not need to patch. Check to see whether any of the change log file dates are later than your FoxPro version date. If so, use the FoxPro text editor to read these files to determine which changes have been made and whether you want to patch. * CHNG1.LOG - Effective July 19, 1991 * CHNG2.LOG - Effective July 30, 1991 * CHNG3.LOG - Effective August 9, 1991 * CHNG4.LOG - Effective August 28, 1991 * CHNG5.LOG - Effective September 19, 1991 * CHNG6.LOG - Effective September 26, 1991 * CHNG7.LOG - Effective October 7, 1991 * CHNG8.LOG - Effective November 7, 1991 * CHNG9.LOG - Effective November 15, 1991 * CHNG10.LOG - Effective March 25, 1992 * CHNG11.LOG - Effective May 20, 1992 * CHNG12.LOG - Effective June 3, 1992 * CHNG13.LOG - Effective June 9, 1992 ---------------------------------------------------------------------- HOW TO USE PATCH ---------------------------------------------------------------------- -------- NOTE Fox recommends that you have at least 2.5 MB of -------- available disk space before you apply a patch. These directions assume that FoxPro is installed in C:\FOXPRO2. If you've installed FoxPro elsewhere, make adjustments accordingly. These directions also assume that you will refer to the documentation for your communications package for specific instructions on downloading from CompuServe. 1. Download PATCH.EXE and PATCH.DBF from CompuServe to the FOXPRO2 directory. -------- CAUTION! PATCH.EXE and PATCH.DBF must be in the same directory -------- as the files being patched. 2. Change to the FoxPro directory by typing CD\FOXPRO2 at the C:> prompt, then pressing Enter. 3. Type PATCH -V and press Enter. This determines which files you must download from CompuServe to the FOXPRO2 directory. 4. If you receive the message "ALL REQUIRED PATCHES ARE PRESENT", go to Step 7. 5. If you receive the message "ALL FILES ARE UP TO DATE," you do not need to patch and you can ignore the remaining instructions. 6. If you receive the message "TOTAL SIZE OF PATCHES NOT FOUND OR OUT OF DATE:XXX", then download the indicated files from CompuServe to the FOXPRO2 directory. You may want to run PATCH -V again to be sure you downloaded the correct files. 7. When all necessary files have been downloaded, type PATCH -P at the FOXPRO2 directory prompt, then press Enter. The message "CHECKING.....APPLYING ALL AVAILABLE PATCHES" appears and a list of files being patched is displayed. The entire process may take some time. This is normal. When the message "DONE" appears at the end of the last file patched, the patch is complete. 8. To verify the patch, type PATCH -V at the prompt and press Enter. If the patch was successful, the message "ALL FILES ARE UP TO DATE" appears. ---------------------------------------------------------------------- PATCH MESSAGES ---------------------------------------------------------------------- Here are the messages that may be displayed when you execute the PATCH utility: "" is not a baseline file. One or more of the files are not baseline files. Re-install the product(s) from the original diskettes and run this program again. Some patches must be applied to the FoxPro version that you installed from your FoxPro diskettes. When this message is displayed, re-install FoxPro from your diskettes. -------- CAUTION! If you have installed the optional FoxPro Distribution Kit, -------- be sure to re-install both FoxPro and the Distribution Kit before you patch. See the next section, BASELINES, for more information. "": Permission denied The PATCH utility does not have write access to the specified file. Change the DOS attribute of the file to read/write and run PATCH again. All files are up to date. You have the most current version of FoxPro, the optional FoxPro Distribution Kit and the help files. You do not have to download any patch files or apply patches. Cannot apply - Patch Not Found. The specified patch file needed by the PATCH utility could not be located. Make sure you have downloaded the patch file and placed it into FoxPro directory. Cannot apply - Patch Out of Date/Invalid. The specified patch file found by the PATCH utility is out of date or corrupt. Download the current patch file from CompuServe into the FoxPro directory. Cannot open PATCH.DBF database file. The PATCH utility cannot open the PATCH.DBF database. This message may be displayed if PATCH.DBF has been erased or is not located in the same directory as PATCH.EXE. -------- CAUTION! PATCH.EXE and PATCH.DBF must be in the same directory -------- as the files being patched. Insufficient memory You do not have enough memory to run the PATCH utility. Free up additional memory and run PATCH again. Out of disk space You do not have enough disk space to run the PATCH utility. Fox recommends that you have at least 2.5 MB of memory available before you apply a patch. Free up additional disk space by deleting unnecessary files and run PATCH again. PATCH.DBF database file is invalid. The PATCH.DBF database is no longer valid. Download the current PATCH.DBF database from CompuServe to your hard drive. Total size of patches not found or out of date: XXX In this message, "XXX" indicates the number of bytes needed to download the necessary files. Download the necessary files from CompuServe to the FoxPro directory. ---------------------------------------------------------------------- BASELINES ---------------------------------------------------------------------- When you type PATCH -V to verify which patch files you need to download, you may receive this message: " is not a baseline file. One or more of the files are not baseline files. Re-install the product(s) from the original diskettes and run this program again." The original FoxPro product you received on floppy disks is referred to as the baseline. When you receive this message you must re-install the specified FoxPro product from the original disks. So that you do not have to re-install each time you receive this message, Fox recommends that you save the appropriate baseline files in a separate subdirectory. The next time you receive a "Not a baseline file..." message, copy the specified baselines from the subdirectory to the FoxPro directory or directories. You can then continue patching. After you install FoxPro, keep copies of the following files in the baseline subdirectory: FOXPRO.EXE Single-User Standard FoxPro FOXPRO.OVL Single-User Standard FoxPro FOXPROX.EXE Single-User Extended FoxPro FOXPROL.EXE Multi-User Standard FoxPro FOXPROL.OVL Multi-User Standard FoxPro FOXPROLX.EXE Multi-User Extended FoxPro FOXHELP.DBF FoxPro help file (database file) FOXHELP.FPT FoxPro help file (memo file) FOXPRO.ESL Distribution Kit Standard Support Library FOXPRO.ESO Distribution Kit Standard Support Library FOXPROX.ESL Distribution Kit Extended Support Library FOXPRO.LIB Distribution Kit Standard Executable Library FOXPROS.LIB Distribution Kit Standard Executable Library FOXPROX.LIB Distribution Kit Extended Executable Library FOXPROSX.LIB Distribution Kit Extended Executable Library FOXCLIBM.LIB Distribution Kit Standard Executable Library FOXCLIBR.LIB Distribution Kit Extended Executable Library ---------------------------------------------------------------------- ADDITIONAL FILES ---------------------------------------------------------------------- Self-extracting replacement files are now available to update the sample applications and programs included with FoxPro. The self-extracting replacement files in the list below assume that these applications and programs are installed in the default directories created during the FoxPro installation. PIECES.EXE Updates the GENMENU.PRG and GENSCRN.PRG menu and screen generation programs, PROAPI16.EXE, FOXAPP.APP, FOXSTART.APP, the FoxPro loaders (FOX.EXE, FOXR.EXE, FOXL.EXE) and the GENGRAPH and GENXTAB.PRG programs used to create graph and cross tab output from the RQBE window. -------- NOTE PIECES.EXE is required in order to install the new RUN menu. -------- ORG.EXE Updates the files used to build the sample organizer application. This has not changed since July 30, 1991. FDOC.EXE Updates FoxDoc, the FoxPro application documenter. DRIVER.EXE Updates the files used to build GENPD.APP, the FoxPro printer driver application FOXAPP.EXE Updates the files used to build FOXAPP.APP, the FoxPro application generator. -------- NOTE The FOXAPP files are placed in a FOXPRO2 subdirectory -------- called FOXAPP. The previous FOXAPP files were in the FOXPRO2\GOODIES\FOXAPP subdirectory. You should now delete the FOXAPP subdirectory under GOODIES. SNPFMT.EXE Updates the files used to build SNIPFMT.APP, the FoxPro snippet formatter. Download the appropriate self-extracting replacement file into the FoxPro directory, then type the name of the self-extracting replacement file with -d and -o switches. For example, to update the ORGANIZER application, type: ORG -d -o Since the appropriate directory structures are built into the self-extracting replacement files, the -d switch is necessary and specifies that the extracted files should be placed into those built-in directories rather than in the current directory. The -o switch specifies that the extracted files should overwrite existing files. Although this switch is not necessary, it eliminates the need to overwrite each file separately, which can be time consuming, considering the number of files extracted. ---------------------------------------------------------------------- CAUTIONS!! ---------------------------------------------------------------------- **PATCH.EXE and PATCH.DBF must be in the same directory as the files being patched. Otherwise the patch process will not work. **If you have installed the optional FoxPro Distribution Kit and need to re-install FoxPro as a baseline, be sure to re-install both FoxPro and the Distribution Kit before you patch. **PATCH.EXE may occasionally be updated. When it is, you will be notified. **Fox recommends that you have at least 2.5 MB of available disk space before you apply a patch.