home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / text / diffutils_2 / !ReadMe1st next >
Text File  |  1995-09-12  |  3KB  |  106 lines
  1. GNU Diffutils 2.7
  2. -----------------
  3.  
  4. This is port of GNU Diffutils version 2.7; including the GNU modified
  5. version of Larry Wall's Patch program (upto version 2.1).
  6.  
  7. You should do the following to install:
  8.  
  9.     ensure !Setup is run from somewhere, or add its contents to your
  10.     desktop boot file---if these variables are not set then things may
  11.     not work as well as they should, if indeed they still work.
  12.     You have been warned ;-)
  13.  
  14.     copy gcmp, gdiff, gdiff3, pr and patch2-1.patch somewhere in your
  15.     Run$Path, ideally into your Library directory.
  16.     
  17. Voila. If this is the first time you have run them, then ensure you double
  18. click on !Setup / reboot before trying them out.
  19.  
  20. These programs do the following:
  21.  
  22.     gcmp
  23.         Byte compare two files.
  24.         
  25.     gdiff
  26.         Differences between two files.
  27.     
  28.     gdiff3
  29.         Three-way difference.
  30.         
  31.     pr
  32.         Rather wild / spaced out hack of the BSD4.4 `pr' program
  33.         to paginate output.
  34.     
  35.     patch
  36.         Patch file according to a file of differences.
  37.  
  38.  
  39. Using
  40. -----
  41.  
  42. Note that as these are all compiled using UnixLib, you do NOT have to use 
  43. the appalling redirection spec. you would normally have to use if you
  44. compiled using Clib:
  45. i.e. you can get away with
  46.  
  47.     gdiff -c foo bar > diff
  48.  
  49. to put a context sensitive diff between foo and bar into the file diff.
  50. You can then patch, similarly, avoiding the gross Acorn redirection spec.
  51. thusly:
  52.  
  53.     patch foo < diff
  54.  
  55. patch foo up to same as bar using context diff in file called diff.
  56.  
  57.  
  58. Bugs
  59. ----
  60. 1. GNU sdiff isn't ported (or rather, it is but I can't see that it's any use
  61. to anyone as it uses `ed' by default on Unix boxes and is not necessary
  62. for RCS, and so it isn't included in this bundle.
  63.  
  64. 2. If you insist on using the paginate output option of diff (hence the 
  65. pr program provided), the output is missing the time and date at the top
  66. of each page which should be present. This is because I'm lazy and couldn't
  67. be bothered fixing the BSD centric timing functions to be more UnixLib
  68. friendly, so I dyked it out. If this offends then prod me and I may fix it.
  69.  
  70. 3. I havent included the sources in this bundle.
  71. Okay, heres a whistle-stop guide to how to hack diffutils if you want to:
  72.  
  73.     1. Download diffutils and patch from a GNU Archive.
  74.     
  75.     2. Manually configure it for Unixlib taking config.h-in as a 
  76.        starting point.
  77.        
  78.     3. If you are porting diffutils then examine system.h and change
  79.        the definition of same_file to always return -1, this forces
  80.        it not to rely on stat() calls to tell if files are the same, it
  81.        seems this call does odd things and isnt entirely reliable.
  82.        (At least, thats what I think it's doing, but you know what GNU's
  83.        like ;-)
  84.        
  85.     4. Add in a -DHAVE_CONFIG_H to the ccflags, and change the <config.h>
  86.        includes in sources to "config.h".
  87.       
  88.     5. Change any references to extern int errno to extern volatile int
  89.        errno.
  90.     
  91.     6. I think that's it...
  92.  
  93.  
  94. any problems using, or suggestions, I'm reachable at:
  95.  
  96. ams@amonsul.demon.co.uk
  97.  
  98. Al Slater,
  99. 65 Ellan Hay Rd,
  100. Bradley Stoke,
  101. Bristol.
  102. BS12 0HA.
  103.  
  104. Note: I'm currently off Net for the Summer, hence no email. This will
  105. be rectified as of about September.
  106.