home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR13 / 4DPATCH1.ZIP / PATCH.DOC < prev    next >
Text File  |  1992-06-08  |  4KB  |  94 lines
  1.                                JP Software
  2.  
  3.                     4DOS Patch Program Documentation
  4.  
  5.                             4.01June 8, 1992
  6.  
  7.  
  8. Copyright 1988 - 1992, JP Software Inc., All Rights Reserved.  Published
  9. by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174 USA, (617)
  10. 646-3975.
  11.  
  12.  
  13. This file explains briefly how the 4DOS 4.01 patch program PATCH.EXE
  14. works and how to use it.
  15.  
  16. The patch program cannot be used by itself -- you must also have a patch
  17. file.  The patch program is provided separately so you can download it
  18. once, then use it with individual patch files when they are issued,
  19. without having to download another copy of the patch program with each
  20. patch file.
  21.  
  22. The patch program converts one or more old 4DOS or 4OS2 files to the
  23. most recent version.  It is part of the .RTPatch software update package
  24. from PocketSoft Inc. (see below).  JP Software uses .RTPatch to generate
  25. "patch" files which contain the differences between the old and new
  26. versions of one or more 4DOS or 4OS2 files.  You then apply these
  27. patches to your copy of 4DOS or 4OS2 to update it to the latest version. 
  28. The patches are usually much smaller than the new file, so this approach
  29. saves download time.
  30.  
  31. A typical patch will include a patch file with the extension .RTP, and a
  32. documentation file with the extension .DOC.  The documentation file with
  33. each patch explains the details for that patch, but in general a patch
  34. is applied in three steps:
  35.  
  36.        (1) Collect the files to be patched and the patch (.RTP) file
  37.        into a single directory.  The patch will not work unless all
  38.        files are in the same directory.  The PATCH.EXE program should be
  39.        in that directory as well, or located in a directory on your
  40.        PATH.
  41.  
  42.        (2) Change to the new directory.
  43.  
  44.        (3) Enter the command:
  45.  
  46.                  PATCH . [patchname]
  47.  
  48.        where [patchname] is the name of the .RTP file (without the
  49.        extension or the square brackets).  Note that a "." is required
  50.        between the PATCH command and [patchname].
  51.  
  52.  
  53. There are a few additional things you should be aware of when running
  54. PATCH:
  55.  
  56.    **  You can only patch the original file for which the patch was
  57.        generated.  If any of the files to be patched has been modified
  58.        in any way since you received it from JP Software, or is not the
  59.        exact version for which the patch was created, then that file
  60.        will not be patched.  For example, if you edit a documentation
  61.        file or an icon, or compress an executable file with PKLITE or
  62.        DIET, then PATCH will not update the file.  This is a safety
  63.        feature which prevents PATCH from modifying the wrong version of
  64.        a file.  The exception is 4DOS and 4OS2 BRANDing:  our patch
  65.        files are constructed to handle the changes created by the BRAND
  66.        program, and to automatically transfer the brand from your old
  67.        4DOS or 4OS2 executable file to the new file.
  68.  
  69.    **  PATCH will ignore missing files.  If the patch you are installing
  70.        is for multiple files and only some files are present, only those
  71.        files will be updated.  You can copy additional files later and
  72.        rerun the PATCH command to update them; this will cause some
  73.        harmless messages when PATCH finds some of the files have already
  74.        been patched.
  75.  
  76.    **  PATCH can be run from DOS, from an OS/2 DOS session, or from an
  77.        OS/2 protected-mode session under 4OS2.EXE or CMD.EXE.  Do not
  78.        use PATCH to update executable files like 4OS2.EXE from an OS/2
  79.        protected-mode session while the program to be updated is
  80.        running.  OS/2 does not allow executable files to be modified
  81.        while they are in use, so PATCH will not be able to update the
  82.        file.  Instead, end the program before applying the patch.  If
  83.        you prefer you can copy the file to another directory, apply the
  84.        patch there, and then either end the program and copy the
  85.        modified file back to the original location, or reconfigure your
  86.        system to use the modified file in the new directory.
  87.  
  88.  
  89. [PATCH.EXE is a copyrighted program, distributed under license to JP
  90. Software.  For more information on the complete .RTPatch software update
  91. package contact PocketSoft, Inc., P.O. Box 821409, Houston, TX 77282,
  92. USA, phone 713-460-5600, fax 713-460-2651.  .RTPatch is a trademark of
  93. PocketSoft Inc.]
  94.