home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PROG_GEN / WS102.ZIP / WS102.EXE / WS102.DOC next >
Text File  |  1994-02-01  |  6KB  |  139 lines
  1.             Patching Win/Sys Library version 1.01 to 1.02
  2.             ---------------------------------------------
  3.                          TurboPower Software
  4.                    Patch scripts updated 94/02/01
  5.  
  6. WS102.EXE is a self-extracting archive that contains a patch file to
  7. transform Win/Sys Library version 1.01 into version 1.02. The patch
  8. 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 WS102.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. WS102.EXE contains one patch file, which you should extract or copy
  18. into your \WINSYS subdirectory. Then move into that subdirectory and
  19. enter the following command at the DOS prompt:
  20.  
  21.     PATCH WS102
  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 \WINSYS
  27. directory once patching is complete. You'll probably want to keep
  28. WS102.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
  31. FASTUPD.102 files for information about the new version.
  32.  
  33. Download UPDATE.TXT from the same place where you found WS102.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.01 up to 1.02. For example,
  42. it cannot bring version 1.00 up to 1.02. 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, OBJ, HLP, TPU, TPW, and TPP are not patched unless they
  51. depend on source code or other files that aren't part of Win/Sys
  52. Library. Be sure to remake all dependent files after you install the
  53. patch. All files but the Windows HLP file can be remade by using the
  54. supplied make or project files, or just by compiling them into your
  55. application. The HLP file can be recreated by entering the following
  56. command in the \WINSYS directory:
  57.  
  58.   HC31 WINSYS.HPJ
  59.  
  60. (HC31.EXE is the Microsoft help compiler, supplied with all
  61. Windows-compatible compilers from Borland and Microsoft.)
  62.  
  63. 3. If you didn't originally install all of Win/Sys Library (e.g., you
  64. installed only the Pascal files), then of course PATCH can't update
  65. the uninstalled portion of the library. This isn't a problem unless
  66. you later install the rest of the older version. In that case, you
  67. must reuse the patch to bring the newly installed files up to the
  68. current version.
  69.  
  70. PATCH does not attempt to patch archive (.LZH) files. You must
  71. dearchive all files that you wish to patch. This applies to BONUS
  72. files as well as production files.
  73.  
  74. 4. PATCH can't find files that you have moved out of the \WINSYS
  75. directory tree. It *can* find files in subdirectories of this
  76. directory, however.
  77.  
  78. This issue is most relevant to the Win/Sys DLLs, which the Win/Sys
  79. INSTALL program copies to your \WINDOWS\SYSTEM directory. To assure
  80. that you have the latest copy of the DLLs, compiled with all the
  81. proper settings, the Win/Sys patch file contains a complete new copy
  82. of the DLLs. These are copied into your \WINSYS directory. Be sure to
  83. transfer these DLLs to your \WINDOWS\SYSTEM directory, replacing the
  84. old DLLs.
  85.  
  86. 5. PATCH doesn't attempt to update certain files because they are
  87. updated automatically during installation or when you configure the
  88. library for your application. Because these files have been customized
  89. for your system, PATCH cannot make reliable changes to them. Even so,
  90. it's often important for us to distribute updated versions of these
  91. files, since there may be new defines and dependencies in them. We
  92. decide on a file by file basis whether to distribute a new copy of
  93. these files or to allow your existing version to remain intact. Here
  94. is a list of affected files for Win/Sys 1.02:
  95.  
  96.   Directory           Filename      In Patch?  New Name or Directory?
  97.   ----------------    ------------  ---------  ----------------------
  98.   \WINSYS\C           WINSYSC.MAK   New copy   WINSYSC.102
  99.   \WINSYS\C           WINSYSCM.MAK  New copy   WINSYSCM.102
  100.   \WINSYS\C\EXAMPLES  *.PRJ         New copy   *.102
  101.   \WINSYS\PASCAL      WINSYS.MAK    New copy   WINSYS.102
  102.   \WINSYS\PASCAL      WINSYSU.MAK   New copy   WINSYSU.102
  103.   \WINSYS\PASCAL      WSDEFINE.INC  New copy   WSDEFINE.102
  104.   various             *.CFG         No
  105.  
  106. When one of these files is distributed as part of the patch, a
  107. complete new copy of it is included, since PATCH probably cannot patch
  108. your modified copy. Where appropriate, the final column of this table
  109. shows the name or directory of the new copy of the file. Be sure to
  110. look at this new file, modify it as appropriate for your environment,
  111. and copy it over the old version before proceeding.
  112.  
  113. Note that CFG files (TURBOC.CFG, TLINK.CFG, TPCW.CFG, BPC.CFG, etc.)
  114. are *not* distributed with this patch. We didn't make any significant
  115. changes to these files.
  116.  
  117. 6. If you modified the TurboPower source code, PATCH refuses to apply
  118. changes to the modified files. (It uses a checksum algorithm to assure
  119. that the file it is patching is the intended version.) In this case,
  120. the only way to get a valid set of patched files is to reinstall an
  121. unmodified copy of Win/Sys Library and patch it, then make your
  122. changes to the new version.
  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.