home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / gnu / gnu-misc-src.lha / GNU / src / README next >
Text File  |  1994-07-13  |  3KB  |  73 lines
  1.  
  2.                GNU UTILITIES README
  3.                  (updated 6/14/94)
  4.  
  5. WHAT IS THIS TREE
  6. -----------------
  7.  
  8. This is the root directory of the source for the GNU utilities supplied
  9. with this distribution.  All of the supplied binaries were compiled from
  10. the sources provided here.  With a few exceptions, they were all compiled
  11. with the gcc compiler also provided here.
  12.  
  13.  
  14. STRUCTURE OF DISTRIBUTION TREE
  15. ------------------------------
  16.  
  17. The tree is subdivided into four subtrees, as follows:
  18.  
  19.     amiga        Sources used to compile the AmigaDOS executables,
  20.             in full unarchived form.
  21.  
  22.     baseline    Original archives from which the "amiga" source
  23.             tree was derived.
  24.  
  25.     diffs        The patch files that were applied to sources
  26.             in the "baseline" subtree (once dearchived) to
  27.             generate the sources in the "amiga" subtree.
  28.             These are applied with "patch -p1 ...".
  29.  
  30.  
  31. GNU C COMPILER versus OTHER C COMPILERS
  32. ---------------------------------------
  33.  
  34. There are many ports of various GNU utilities which have been compiled with
  35. a compiler other than gcc (compiled with SAS C or Dice for example).  It
  36. was tempting to just include them "as is", however I've generally resisted
  37. that temptation, prefering instead to compile my own binaries using the GNU
  38. C compiler.
  39.  
  40. In many cases, compilation with the GNU C compiler has minimized the source
  41. changes required to produce a binary, thanks to Markus Wild's excellent
  42. Unix emulation environment.  However it is likely that it has introduced
  43. bugs in the process, since it was not always easy to tell which changes
  44. made to a piece of code compiled with another compiler were dependent on
  45. that compiler (and thus not wanted or needed for gcc compilation), or
  46. dependent on AmigaDOS as the host machine (probably needed regardless of
  47. the compiler).  The authors of various ports of GNU utilities have not
  48. always been careful about how they made their changes or how they marked
  49. them in the source code, assuming they even made the source code available
  50. in the first place.
  51.  
  52. So, it is likely that the first few releases of these utilities may be
  53. somewhat fragile.  Since I think it is an important goal of this distri-
  54. bution that eventually all of the supplied GNU source be stable when
  55. compiled with the supplied GNU C compiler (and as much non-GNU source as
  56. possible as well), rather than a random selection of C compilers that may
  57. not be available to the person using this distribution, I think it is worth
  58. the temporary aggravation of stumbling over bugs resulting from a not quite
  59. completed port.
  60.  
  61. When you find a problem that is specific to the Amiga port, please try to
  62. identify it's source, and even better, provide a suggested fix to the
  63. supplied source code.
  64.  
  65. I will be making a serious effort to see that the Amiga specific patches
  66. made to this source tree get folded back into the FSF distributions so that
  67. eventually the source trees will converge, and it will be possible to build
  68. a complete set of GNU tools from unchanged FSF source.  This is the ideal,
  69. it may not be possible to achieve in practice, though I think it is a
  70. worthy goal.
  71.  
  72. -Fred Fish  ><>
  73.