home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / patch-go.lbr / P&G10.DZC / P&G10.DOC
Encoding:
Text File  |  1993-10-25  |  4.5 KB  |  103 lines
  1.                     PATCH&GO v1.0 (07/17/86)
  2.                Copyright (c) 1986 by John D. Osnes
  3.  
  4.  
  5. PATCH&GO  brings  the "poke & go" technique of ZCPR3 to CP/M  2.2 
  6. users.  PATCH&GO prompts the user for patches to another program, 
  7. then saves a program which will load the other program, patch it, 
  8. and finally execute the patched program.   PATCH&GO is internally 
  9. documented:   simply  execute PATCH&GO without any arguments  and 
  10. help will be displayed.   A command menu is displayed before  the 
  11. user is prompted for patches.
  12.  
  13.  
  14. USAGE:            PATCH&GO c:comfile d:patfile
  15.  
  16. where:  c:comfile = name  of the program to be  loaded,  patched, 
  17.                     and  executed (c:  specifies the drive  where 
  18.                     the program will be found when it is  loaded; 
  19.                     c:  defaults  to the drive currently selected 
  20.                     AT  THE TIME "comfile" IS LOADED or to  drive 
  21.                     A: if "comfile" is not found on the currently 
  22.                     selected drive)
  23.  
  24.         d:patfile = name  of the program created by PATCH&GO that 
  25.                     will load,  patch,  and execute "comfile" (d: 
  26.                     specifies  the drive where the  "patfile"  is 
  27.                     saved  and defaults to the currently selected 
  28.                     drive)
  29.  
  30. Both filenames ARE REQUIRED and can not contain  wildcards.   The 
  31. COM file type is implied on both files.
  32.  
  33.  
  34. The  major  problem with PATCH&GO is in the specification of  the 
  35. drive for "comfile" (c:).   A couple of examples best  illustrate 
  36. this  problem.   Consider a "patfile" created using the following 
  37. command:
  38.  
  39.                     A>PATCH&GO COMFILE B:PATFILE
  40.  
  41. where COMFILE.COM is also on the disk in drive B.   An attempt to 
  42. execute PATFILE using the following command:
  43.  
  44.                     A>B:PATFILE  (disk containing PATFILE.COM and 
  45.                                  COMFILE.COM is in drive B)
  46.                  
  47. will  result in an error because COMFILE.COM can not be found  on 
  48. the currently selected drive (A,  as shown by the prompt).   This 
  49. error occurs even though PATFILE.COM was explicitly specified  as 
  50. being on drive B.   The following commands will all execute with-
  51. out  error (note the currently selected drive shown by the prompt 
  52. in each case):
  53.  
  54.                     B>PATFILE    (disk containing PATFILE.COM and 
  55.                                  COMFILE.COM is  in drive B,  the 
  56.                                  currently selected drive)
  57.  
  58.                     C>A:PATFILE  (disk containing PATFILE.COM and 
  59.                                  COMFILE.COM is in drive A)
  60.  
  61. The last case is successful because like ZCPR,  the disk in drive 
  62. A is searched for COMFILE.COM if it is not found on the currently 
  63. selected drive (C) and the drive for "comfile" was not explicitly 
  64. specified  at the time "patfile" was created.   This  feature  of 
  65. PATCH&GO can be disabled by setting equate DEFDRV to FALSE in the 
  66. source for PATCH&GO and re-assembling it with ASM.
  67.  
  68. Now consider a "patfile" created using the following command:
  69.  
  70.                     A>PATCH&GO B:COMFILE B:PATFILE
  71.  
  72. where once again COMFILE.COM is also on the disk in drive B.   In 
  73. this case, the following command will execute sucessfully:
  74.  
  75.                     A>B:PATFILE  (disk containing PATFILE.COM and 
  76.                                  COMFILE.COM is in drive B)
  77.  
  78. because  drive  B  (and  only drive B)  is  always  searched  for 
  79. COMFILE.COM.   However,  the  following  commands will result  in 
  80. errors:
  81.  
  82.                     C>PATFILE    (disk containing PATFILE.COM and 
  83.                                  COMFILE.COM is in drive C)
  84.  
  85.                     B>A:PATFILE  (disk containing PATFILE.COM and 
  86.                                  COMFILE.COM is in drive A)
  87.  
  88. An  error occurs in the last case because drive A is not searched 
  89. for COMFILE.COM when the drive for "comfile" is explicitly speci-
  90. fied at the time "patfile" is created.
  91.  
  92.  
  93. COPYRIGHT (c) 1986 by    John D. Osnes
  94.                          1084 6th Street #41
  95.                          Albany, CA   94710
  96.  
  97. PATCH&GO  may be copied and distributed freely at no cost for the 
  98. benefit and enjoyment of all registered CP/M users.   It may  not 
  99. be  sold or included in a package for sale without prior  written 
  100. permission of the copyright owner.   The author specifically dis-
  101. claims  any warranties,  implied or otherwise,  as to the perfor-
  102. mance and suitability of PATCH&GO.
  103.