home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / c / clip52a.zip / 52ADOC.TXT < prev    next >
Text File  |  1993-03-15  |  8KB  |  173 lines
  1.       CA-CLIPPER 5.2a  - MAINTENANCE RELEASE UPDATE NOTES.
  2.  
  3. To address the minor problems found with the initial release of CA-Clipper 5.2 
  4. Computer Associates has produced patch files to update version 5.2 to version 
  5. 5.2a.   Should others be found, CA will make them available to you via the 
  6. CLIPPER forum on CompuServe.
  7.  
  8.  
  9. REQUIRED FILES FOR PERFORMING UPDATE.
  10.  
  11.    52AUS.EXE   A self exploding .ZIP file that may be downloaded from the
  12.                CLIPPER forum (library 0) on CompuServe. (GO CLIPPER).
  13.  
  14.    PATCH.EXE   Updating engine required for use with 52ABIN.RTP and
  15.                52ALIB.RTP.  This file is also in Library 0 of the CLIPPER
  16.                CompuServe forum.
  17.  
  18.  
  19. CONTENTS OF 52AUS.EXE
  20.  
  21.    52ABIN.RTP   Updating file for CLIPPER.EXE & CLD.EXE
  22.  
  23.    52ALIB.RTP   Updating file for CLIPPER.LIB, CLD.LIB, EXTEND.LIB & DBFNTX.LIB
  24.  
  25.    CT2PATCH.OBJ For developers who have Nantucket Tools-II.
  26.  
  27.    52ADOC.TXT   This file.
  28.  
  29.  
  30. UPDATE PROCESS (using example directories).
  31.  
  32.    o   Make sure that you have placed PATCH.EXE in a directory
  33.        which is on your DOS path.
  34.  
  35.    o   Make a new directory, move 52AUS.EXE into this new directory and
  36.        run it. 
  37.                 EXAMPLE:
  38.                         C:\> MD C:\DWNLD
  39.                         C:\> COPY 52AUS.EXE C:\DWNLD
  40.                         C:\> CD C:\DWNLD
  41.                         C:\DWNLD> 52AUS
  42.  
  43.    o   Take CT2PATCH.OBJ and move it to your CA-Clipper 5.2 OBJ directory.
  44.  
  45.                 EXAMPLE:
  46.                         C:\DWNLD> COPY CT2PATCH.OBJ  C:\CLIPPER5\OBJ 
  47.  
  48.    o   Take 52ABIN.RTP and move it to your CA-Clipper 5.2 BIN directory.
  49.                 EXAMPLE:
  50.                         C:\DWNLD> COPY 52ABIN.RTP  C:\CLIPPER5\BIN
  51.  
  52.    o   Move to your BIN directory, type PATCH 52ABIN and watch the
  53.        patch program update the appropriate files.  A summary will
  54.        be displayed on your screen.
  55.                 EXAMPLE:
  56.                         C:\DWNLD> CD ..\CLIPPER5\BIN
  57.                         C:\CLIPPER5\BIN> PATCH 52ABIN
  58.  
  59.    o   Take 52ALIB.RTP and move it to your CA-Clipper 5.2 LIB directory.
  60.                 EXAMPLE:
  61.                         C:\CLIPPER5\BIN\> CD ..\LIB
  62.                         C:\CLIPPER5\LIB\> COPY C:\DWNLD\52ALIB.RPT
  63.  
  64.    o   Move to your LIB directory, type PATCH 52ALIB and watch the
  65.        patch program update the appropriate files.  A summary will
  66.        be displayed on your screen.
  67.                 EXAMPLE:
  68.                 C:\CLIPPER5\LIB> PATCH 52ALIB
  69.  
  70.    o   The update process is now complete.
  71.  
  72.    NOTE:   The process of updating your BIN and LIB files will create a
  73.            sub-directory called \BACKUP appearing off both your BIN 
  74.            and LIB sub-directories (C:\CLIPPER5\BIN\BACKUP and 
  75.            C:\CLIPPER5\LIB\BACKUP).  These new directories will contain 
  76.            the original version of the patched files.  You may delete
  77.            these files and directories but, if space is available, it
  78.            is recommend that you retain them for future use.
  79.  
  80.  
  81. WHAT EXACTLY HAS BEEN CHANGED? - CHECKING THAT THE UPDATE PROCESS WORKED.
  82.  
  83.    o   In your BIN directory - CLIPPER.EXE and CLD.EXE should be dated
  84.        3/15/93; time stamp should be 5:21AM.
  85.  
  86.    o   In your LIB directory - CLIPPER.LIB, CLD.LIB, EXTEND.LIB and
  87.        DBFNTX.LIB should be dated 3/15/93; time stamp should be 5:21AM.
  88.  
  89.    o   In your OBJ directory - CT2PATCH.OBJ dated 3/15/93 should be
  90.        present.
  91.  
  92.    o   All your other files should be dated 2/15/93; time stamp should 
  93.        be 5:20AM.
  94.  
  95.    NOTE:   If you use PLL files you need to rebuild them!
  96.            You may also wish to rebuild DBU and the other utilities.
  97.                 EXAMPLE:
  98.                         C:\CLIPPER5\PLL> RTLINK @BASE52.LNK
  99.  
  100.  
  101. PROBLEMS ADDRESSED BY CA-Clipper 5.2a
  102.  
  103.    o   C3049 - String Space exhausted. - Change to CLIPPER.EXE
  104.        The compiler has been changed to increase the available string
  105.        space.  Developers whose applications compiled with this error in
  106.        previous versions of Clipper should no longer receive this error
  107.        message.
  108.  
  109.    o   Debugger Break Point Handling. - Change to CLD.EXE & CLD.LIB
  110.        The debugger has been changed to improve Break Point handling.
  111.        Developers who noticed difficulty in setting break points or noticed
  112.        that break points were lost upon application restart will no
  113.        longer have problems.
  114.  
  115.    o   Memoedit() double spacing problem. - Change to EXTEND.LIB
  116.        The Memoedit() function has been changed to alleviate a double
  117.        spacing effect which sometimes occurred.  The only developers who
  118.        noticed this problem had memo field data which had a trailing space
  119.        at the wrap point.  While this problem was uncommon it could be
  120.        very disconcerting in applications where the format of memo field
  121.        data is important.
  122.  
  123.    o   Inkey() setting Lastkey() to 0. - Change to CLIPPER.LIB
  124.        The Inkey() function has been changed. The Inkey() function in 
  125.        CA-Clipper 5.2a will only set the Lastkey() value when a key is 
  126.        drawn from the keyboard buffer.  The Inkey() function in version 
  127.        5.20 set the Lastkey() value to 0 when there was no key in the 
  128.        keyboard buffer to retrieve and the time value expired.  The 5.20
  129.        behavior had an adverse effect on several systems which use 
  130.        Inkey(); for example Memoedit() with a custom UDF() where the UDF() 
  131.        had been coded to expect the last navigational key pressed to be 
  132.        available via Lastkey() would receive a value of 0.
  133.  
  134.    o   OrdSetFocus() tag in lowercase. - Change to DBFNTX.LIB
  135.        The OrdSetFocus() function will now accept parameters in any case.  
  136.        Developers who changed their applications to use order names rather 
  137.        than order numbers noticed that unless the name was in upper case 
  138.        the order established would be natural (no) order.  This problem was 
  139.        unique to the DBFNTX driver.
  140.  
  141.    o   Tools-II with Clipper 5.2x - CT2PATCH.OBJ
  142.        Developers using Tools-II noticed unresolved symbols at link time.  
  143.        This file will resolve these problems and should be included 
  144.        as an object on the link line.
  145.  
  146.        Note: CT2PATCH.OBJ is only intended for use with Tools-II, those not 
  147.              using Tools-II should not include this file in their applications.
  148.  
  149.  
  150. SUPPORT NOTES CA-Clipper 5.01 vs 5.2x
  151.  
  152.    o   _GET_() - Changed in 5.2 and may effect 3rd Party products.
  153.        If you have noticed that sometimes GETs don't appear then your 
  154.        application is probably making a call to _GET_().  The call to 
  155.        this internal function may be invoked from a 3rd party product.
  156.  
  157.        The CA-Clipper internal function _GET_() has changed from version 
  158.        5.01 to 5.2x.  In 5.2x _GET_() no longer displays the GET. The GET 
  159.        is now only displayed after a call to the get_object:Display() 
  160.        method.  Developers or 3rd parties who depended on the old behavior 
  161.        will either have to re-write the offending code, recompile, or ask 
  162.        the 3rd party vendor to supply a 5.2x compatible version of the 
  163.        library.
  164.  
  165.    o   Avoid calls to Internal Functions.
  166.        As a reminder. Developers should not rely on the behavior of 
  167.        internal functions, (those that start with one or more "_").  
  168.        Calling internal functions is strongly discouraged by Computer 
  169.        Associates as there is no guarantee the behavior of these 
  170.        internals will remain consistant between versions.  
  171.  
  172.                                  >>End<<
  173.