home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PROG_GEN / APR112.ZIP / APR112.EXE / APRO112.DOC next >
Text File  |  1994-02-01  |  6KB  |  126 lines
  1.           Patching Async Professional version 1.11 to 1.12
  2.           -------------------------------------------------
  3.                          TurboPower Software
  4.                     Patch scripts updated 94/02/01
  5.  
  6. APR112.EXE is a self-extracting archive that contains patch files
  7. to transform Async Professional version 1.11 into version 1.12. 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 APR112.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. APR112.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 APRO112
  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. APR112.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 APR112.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.11 up to 1.12. For example,
  42. it cannot bring version 1.04 up to 1.12. 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.12:
  89.  
  90.   Directory         Filename      In Patch?  New Name or Directory?
  91.   ----------------  ------------  ---------  ----------------------
  92.   \APRO             APDEFINE.INC  New copy   APDEFINE.112
  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. If you have questions or problems regarding the patch, please contact
  112. us:
  113.  
  114.   TurboPower Software
  115.   P.O. Box 49009
  116.   Colorado Springs, CO 80949-9009
  117.  
  118.   voice: 719-260-6641
  119.   fax:   719-260-7151
  120.   BBS:   719-260-9726
  121.  
  122.   CompuServe ID: 76004,2611
  123.   Pascal forum:  PCVENB section 6
  124.   C/C++ forum:   PCVENE section 1
  125.   Internet:      76004.2611@compuserve.com
  126.