home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PROG_GEN / APRB111.ZIP / APR111.EXE / APRO111.DOC next >
Text File  |  1994-02-01  |  6KB  |  139 lines
  1.           Patching Async Professional version 1.10 to 1.11
  2.           -------------------------------------------------
  3.                          TurboPower Software
  4.                     Patch scripts updated 94/02/01
  5.  
  6. APR111.EXE is a self-extracting archive that contains patch files
  7. to transform Async Professional version 1.10 into version 1.11. The
  8. patch file was generated using Pocket Soft's .RTPatch utility (version
  9. 2.01).
  10.  
  11. If you don't already have a copy of PATCH.EXE, you can download it
  12. from the same place where you found APR111.EXE. Store PATCH.EXE in a
  13. directory that is on your DOS PATH. You'll probably want to keep a
  14. copy of PATCH.EXE, since it can be used to apply all TurboPower
  15. maintenance patches.
  16.  
  17. APR111.EXE contains one patch file, which you should extract or
  18. copy into your \APRO subdirectory. Then move into that subdirectory
  19. and enter the following command at the DOS prompt:
  20.  
  21.     PATCH APRO111
  22.  
  23. PATCH provides running status of the patch process, and displays a
  24. summary when patching is complete.
  25.  
  26. You can delete the patch file (extension .RTP) from your \APRO
  27. directory once patching is complete. You'll probably want to keep
  28. APR111.EXE for a while, in case repatching is required (see below).
  29.  
  30. As with any TurboPower update, see the READ.ME, READ.1ST, and FASTUPD
  31. files for information about the new version.
  32.  
  33. Download UPDATE.TXT from the same place where you found APR111.EXE for
  34. additional background information about the patching process,
  35. available patch files, etc.
  36.  
  37.  
  38. Be aware of the following limitations of the patching process:
  39. --------------------------------------------------------------
  40.  
  41. 1. The patch only works to bring version 1.10 up to 1.11. For example,
  42. it cannot bring version 1.04 up to 1.11. You need a separate patch
  43. file for each incremental version.
  44.  
  45. 2. Dependent files that you can rebuild yourself are *not* patched.
  46. This keeps the size of the patch file to a minimum. In many cases,
  47. such patches would be wasted anyway, since there are so many different
  48. ways the dependent files can be created (with varying defines,
  49. compiler options, compiler versions, etc.). Files with the extensions
  50. EXE, LIB, HLP, TPU, TPW, and TPP are not patched unless they depend on
  51. source code or other files that aren't part of Async Professional. Be
  52. sure to remake all dependent files after you install the patch. All
  53. files but the HLP file can be remade by using the supplied make or
  54. project files, or just by compiling them into your application. The
  55. HLP file can be recreated by entering the following command in the
  56. \APRO directory (or wherever you have stored your APRO help files):
  57.  
  58.   MAKEHELP /Q APRO
  59.  
  60. Note in particular that COMTEST.EXE and COMTESTO.EXE are not part of
  61. the patch. If you use these programs, be sure to recompile them after
  62. applying the patch. These programs are made by APRO.MAK and APROO.MAK,
  63. respectively. On the other hand, OOPCOM.EXE and OOPINST.EXE *are* part
  64. of the patch, since they depend on Object Professional.
  65.  
  66. 3. If you didn't originally install all of Async Professional, then
  67. of course PATCH can't update the uninstalled portion of the library.
  68. This isn't a problem unless you later install the rest of the older
  69. version. In that case, you must reuse the patch to bring the newly
  70. installed files up to the current version.
  71.  
  72. PATCH does not attempt to patch archive (.LZH) files. You must
  73. dearchive all files that you wish to patch. This applies to BONUS
  74. files as well as production files.
  75.  
  76. 4. PATCH can't find files that you have moved out of the \APRO
  77. directory. It *can* find files in subdirectories of this directory,
  78. however.
  79.  
  80. 5. PATCH doesn't attempt to update certain files because they are
  81. updated automatically during installation or when you configure the
  82. library for your application. Because these files have been customized
  83. for your system, PATCH cannot make reliable changes to them. Even so,
  84. it's often important for us to distribute updated versions of these
  85. files, since there may be new defines and dependencies in them. We
  86. decide on a file by file basis whether to distribute a new copy of
  87. these files or to allow your existing version to remain intact. Here
  88. is a list of affected files for APRO 1.11:
  89.  
  90.   Directory         Filename      In Patch?  New Name or Directory?
  91.   ----------------  ------------  ---------  ----------------------
  92.   \APRO             APDEFINE.INC  New copy   APDEFINE.111
  93.   \APRO             SIMPCOM.DAT   No
  94.   \APRO             OOPCOM.CFG    No
  95.   \APRO             OOPCOM.PB     No
  96.  
  97. When one of these files is distributed as part of the patch, a
  98. complete new copy of it is included, since PATCH probably cannot patch
  99. your modified copy. Where appropriate, the final column of this table
  100. shows the name or directory of the new copy of the file. Be sure to
  101. look at this new file, modify it as appropriate for your environment,
  102. and copy it over the old version before proceeding.
  103.  
  104. 6. If you modified the TurboPower source code, PATCH refuses to apply
  105. changes to the modified files. (It uses a checksum algorithm to assure
  106. that the file it is patching is the intended version.) In this case,
  107. the only way to get a valid set of patched files is to reinstall an
  108. unmodified copy of Async Professional and patch it, then make your
  109. changes to the new version.
  110.  
  111. 7. In APRO 1.11, Fossil and Digiboard support was incorporated tightly
  112. with the library and converted from bonus to production status. The
  113. following files in your APRO BONUS directory are obsolete as of
  114. version 1.11: APCOMD.PAS, APCOMF.PAS, APDIGI14.PAS, APFOSSIL.PAS,
  115. DIGI14.DOC, DTEST.PAS, DTESTO.PAS, FOSSIL.DOC, FTEST.PAS, FTESTO.PAS,
  116. OODIGI14.PAS, and OOFOSSIL.PAS. The patch program does not delete
  117. them, however, just in case you need them for something else.
  118.  
  119. Some of these files become production files in version 1.11. Complete
  120. new versions of the following files are installed by the patch in your
  121. \APRO directory: APDIGI14.PAS, APFOSSIL.PAS, DTEST.PAS, DTESTO.PAS,
  122. FTEST.PAS, and FTESTO.PAS.
  123.  
  124. If you have questions or problems regarding the patch, please contact
  125. us:
  126.  
  127.   TurboPower Software
  128.   P.O. Box 49009
  129.   Colorado Springs, CO 80949-9009
  130.  
  131.   voice: 719-260-6641
  132.   fax:   719-260-7151
  133.   BBS:   719-260-9726
  134.  
  135.   CompuServe ID: 76004,2611
  136.   Pascal forum:  PCVENB section 6
  137.   C/C++ forum:   PCVENE section 1
  138.   Internet:      76004.2611@compuserve.com
  139.