home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 November / PCO1197.ISO / FilesBBS / DOS / WATERGAT.EXE / PATCH.RAR / PATCH.TXT next >
Encoding:
Text File  |  1997-07-06  |  5.3 KB  |  142 lines
  1.  
  2.      W...W
  3.      W.W.W
  4.      .W.W.
  5.  
  6.      WaterGate
  7.      Message processor for FidoNet & Internet/Usenet
  8.      Patching Instructions
  9.  
  10.      Copyright (c) 1993-1997 Waterline Software Development
  11.                              All Rights Reserved
  12.  
  13.  
  14. 6 July 1997
  15.  
  16. This document explains how patch files for WaterGate work, how you
  17. can get them and how to apply them.
  18.  
  19.  
  20. About patches
  21. -------------
  22.  
  23. If a small bug has been fixed in for example wtrgate.exe, then I
  24. do not have to release a new version and I neither have to send
  25. everybody a new executable of over 400Kb.
  26.  
  27. Instead, I create a so call "patch" file that can be used to upgrade
  28. wtrgate.exe to the new version. The patch file must be applied with
  29. the program UNDIF.EXE that can be found in the same archive where
  30. this document came from.
  31.  
  32. The patch file is a binary file with the extension .DIF. It contains
  33. a list of all the changes that have to be made to the current
  34. wtrgate.exe to get the new one. This is basically a list of "copy
  35. this part, modify that byte, move this here, move that there" and
  36. so on.
  37.  
  38. The patch file must always be applied to the correct version of the
  39. executable. I always state in the upgrade.doc that accompanies the
  40. .DIF file to which .exe file you have to apply the patch. Most of
  41. the time this will be the latest version. If I release patch 1,
  42. you have to apply it to the .exe file from the distribution archive.
  43. If I release patch 2, you have to apply it to the patch 1 executable.
  44.  
  45. The patches are called P1, P2, P3 and so on and the version numbers
  46. change accordingly: from 0.93 to 0.93.p1, 0.93.p2 and so on. The
  47. distribution archives for the patches are named wg<version>P<patch>,
  48. for example wg093p1.zip for patch level 1 for WaterGate version 0.93.
  49. The files inside the patch archive are always called wtrgate.dif for
  50. wtrgate.exe, wtrutil.dif for wtrutil.exe and so on.
  51.  
  52. The patches not always upgrade *all* the executables. Some only
  53. upgrade wtrgate.exe other upgrade wtrconf.exe and wtrutil.exe as well.
  54. Special patches for WtrConf, WtrUtil and WtrTest are named wc, wu
  55. and wt instead of wg. For example wu090p8, which only upgrades
  56. WtrUtil. Patches can upgrade the helpfile (wtrgate.hlp) as well.
  57. This patch is mostly call wtrhelp.dif. The .ovr file has wtrovr.dif.
  58.  
  59.  
  60. Where can I get the patch files?
  61. --------------------------------
  62.  
  63. You should be able to find the patch files in the same place where
  64. you found WaterGate. Check getnew.txt for the hottest places on
  65. earth. People having WaterGate on-line for file request are kindly
  66. asked to allow the patches to be requested by their original
  67. filename.
  68.  
  69. As a last resort, you can always get the patches from me via e-mail
  70. by sending a message to <patch archive name>-req@wsd.wline.se, for
  71. example wg093p1-req@wsd.wline.se. Sometimes the patches are so big
  72. that I do not appreciate it when loads of people request it over
  73. my UUCP dial-up connection. If the patch is small, I don't care.
  74.  
  75.  
  76. How do I know there is a new patch?
  77. -----------------------------------
  78.  
  79. Subscribe to the announcement mailing list WaterGate. Send a message
  80. to listserv@wsd.wline.se and put nothing in the body except
  81. "connect watergate" (without the quotes) and you are certain to get
  82. an e-mail when I release a new version or a patch.
  83.  
  84.  
  85. How to apply a patch
  86. --------------------
  87.  
  88. When you have received a patch, you unzip the archive and find at
  89. least two files: one upgrade.doc which you must read very carefully
  90. and one or more .dif files.
  91.  
  92. Read the upgrade.doc to find out which executables to upgrade and
  93. copy these in a new directory. Also copy the .dif files and the
  94. program undif.exe into that same directory. Then, type the following
  95. command to start the patching process:
  96.  
  97. UNDIF *
  98.  
  99. The undif program will now search for all .DIF file, checks the
  100. executable for the correct version and then apply the patch. The
  101. executable is not renamed but keeps its original name. No backup
  102. is made either.
  103.  
  104. When all executables have been patched successfully, you should
  105. *NOT* just copy them in place and run them. Make a backup of your
  106. WaterGate directory first! Make sure to backup the executables
  107. and the database file, so you can always return to an older
  108. version if the need would arise.
  109.  
  110. When you have made the backup, then copy the new executables into
  111. the WaterGate directory.
  112.  
  113.  
  114. Upgrading databases
  115. -------------------
  116.  
  117. Some patches come with an upgrade.exe program which upgrades your
  118. database files (*.tdb) as well. If so, you have to run this program
  119. first before you can use the new executables. If you run more than
  120. one configuration (in different directories), then make sure you run
  121. upgrade.exe in each of these directories to upgrade all the
  122. database files.
  123.  
  124. Before you continue, go back to upgrade.doc to see if the changes
  125. made to the executables or databases might impact your system and
  126. you perhaps need to make other changes.
  127.  
  128. You are now ready to run the new executables. First run each of
  129. the executables to make sure they function and do not crash your
  130. system.
  131.  
  132. If everything seems OK, then start to test the new changes that
  133. were made. You have successfully patched your WaterGate system!
  134.  
  135. Mail me if you have any questions or comments to this document.
  136.  
  137. Ramon
  138.  
  139. ramon@wsd.wline.se
  140. ramon.winkel@ex1.ecs.ericsson.se
  141.  
  142.