CA-CLIPPER 5.2a - MAINTENANCE RELEASE UPDATE NOTES. To address the minor problems found with the initial release of CA-Clipper 5.2 Computer Associates has produced patch files to update version 5.2 to version 5.2a. Should others be found, CA will make them available to you via the CLIPPER forum on CompuServe. REQUIRED FILES FOR PERFORMING UPDATE. 52AUS.EXE A self exploding .ZIP file that may be downloaded from the CLIPPER forum (library 0) on CompuServe. (GO CLIPPER). PATCH.EXE Updating engine required for use with 52ABIN.RTP and 52ALIB.RTP. This file is also in Library 0 of the CLIPPER CompuServe forum. CONTENTS OF 52AUS.EXE 52ABIN.RTP Updating file for CLIPPER.EXE & CLD.EXE 52ALIB.RTP Updating file for CLIPPER.LIB, CLD.LIB, EXTEND.LIB & DBFNTX.LIB CT2PATCH.OBJ For developers who have Nantucket Tools-II. 52ADOC.TXT This file. UPDATE PROCESS (using example directories). o Make sure that you have placed PATCH.EXE in a directory which is on your DOS path. o Make a new directory, move 52AUS.EXE into this new directory and run it. EXAMPLE: C:\> MD C:\DWNLD C:\> COPY 52AUS.EXE C:\DWNLD C:\> CD C:\DWNLD C:\DWNLD> 52AUS o Take CT2PATCH.OBJ and move it to your CA-Clipper 5.2 OBJ directory. EXAMPLE: C:\DWNLD> COPY CT2PATCH.OBJ C:\CLIPPER5\OBJ o Take 52ABIN.RTP and move it to your CA-Clipper 5.2 BIN directory. EXAMPLE: C:\DWNLD> COPY 52ABIN.RTP C:\CLIPPER5\BIN o Move to your BIN directory, type PATCH 52ABIN and watch the patch program update the appropriate files. A summary will be displayed on your screen. EXAMPLE: C:\DWNLD> CD ..\CLIPPER5\BIN C:\CLIPPER5\BIN> PATCH 52ABIN o Take 52ALIB.RTP and move it to your CA-Clipper 5.2 LIB directory. EXAMPLE: C:\CLIPPER5\BIN\> CD ..\LIB C:\CLIPPER5\LIB\> COPY C:\DWNLD\52ALIB.RPT o Move to your LIB directory, type PATCH 52ALIB and watch the patch program update the appropriate files. A summary will be displayed on your screen. EXAMPLE: C:\CLIPPER5\LIB> PATCH 52ALIB o The update process is now complete. NOTE: The process of updating your BIN and LIB files will create a sub-directory called \BACKUP appearing off both your BIN and LIB sub-directories (C:\CLIPPER5\BIN\BACKUP and C:\CLIPPER5\LIB\BACKUP). These new directories will contain the original version of the patched files. You may delete these files and directories but, if space is available, it is recommend that you retain them for future use. WHAT EXACTLY HAS BEEN CHANGED? - CHECKING THAT THE UPDATE PROCESS WORKED. o In your BIN directory - CLIPPER.EXE and CLD.EXE should be dated 3/15/93; time stamp should be 5:21AM. o In your LIB directory - CLIPPER.LIB, CLD.LIB, EXTEND.LIB and DBFNTX.LIB should be dated 3/15/93; time stamp should be 5:21AM. o In your OBJ directory - CT2PATCH.OBJ dated 3/15/93 should be present. o All your other files should be dated 2/15/93; time stamp should be 5:20AM. NOTE: If you use PLL files you need to rebuild them! You may also wish to rebuild DBU and the other utilities. EXAMPLE: C:\CLIPPER5\PLL> RTLINK @BASE52.LNK PROBLEMS ADDRESSED BY CA-Clipper 5.2a o C3049 - String Space exhausted. - Change to CLIPPER.EXE The compiler has been changed to increase the available string space. Developers whose applications compiled with this error in previous versions of Clipper should no longer receive this error message. o Debugger Break Point Handling. - Change to CLD.EXE & CLD.LIB The debugger has been changed to improve Break Point handling. Developers who noticed difficulty in setting break points or noticed that break points were lost upon application restart will no longer have problems. o Memoedit() double spacing problem. - Change to EXTEND.LIB The Memoedit() function has been changed to alleviate a double spacing effect which sometimes occurred. The only developers who noticed this problem had memo field data which had a trailing space at the wrap point. While this problem was uncommon it could be very disconcerting in applications where the format of memo field data is important. o Inkey() setting Lastkey() to 0. - Change to CLIPPER.LIB The Inkey() function has been changed. The Inkey() function in CA-Clipper 5.2a will only set the Lastkey() value when a key is drawn from the keyboard buffer. The Inkey() function in version 5.20 set the Lastkey() value to 0 when there was no key in the keyboard buffer to retrieve and the time value expired. The 5.20 behavior had an adverse effect on several systems which use Inkey(); for example Memoedit() with a custom UDF() where the UDF() had been coded to expect the last navigational key pressed to be available via Lastkey() would receive a value of 0. o OrdSetFocus() tag in lowercase. - Change to DBFNTX.LIB The OrdSetFocus() function will now accept parameters in any case. Developers who changed their applications to use order names rather than order numbers noticed that unless the name was in upper case the order established would be natural (no) order. This problem was unique to the DBFNTX driver. o Tools-II with Clipper 5.2x - CT2PATCH.OBJ Developers using Tools-II noticed unresolved symbols at link time. This file will resolve these problems and should be included as an object on the link line. Note: CT2PATCH.OBJ is only intended for use with Tools-II, those not using Tools-II should not include this file in their applications. SUPPORT NOTES CA-Clipper 5.01 vs 5.2x o _GET_() - Changed in 5.2 and may effect 3rd Party products. If you have noticed that sometimes GETs don't appear then your application is probably making a call to _GET_(). The call to this internal function may be invoked from a 3rd party product. The CA-Clipper internal function _GET_() has changed from version 5.01 to 5.2x. In 5.2x _GET_() no longer displays the GET. The GET is now only displayed after a call to the get_object:Display() method. Developers or 3rd parties who depended on the old behavior will either have to re-write the offending code, recompile, or ask the 3rd party vendor to supply a 5.2x compatible version of the library. o Avoid calls to Internal Functions. As a reminder. Developers should not rely on the behavior of internal functions, (those that start with one or more "_"). Calling internal functions is strongly discouraged by Computer Associates as there is no guarantee the behavior of these internals will remain consistant between versions. >>End<<