home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / flex-2.4.6-src.lha / src / README next >
Text File  |  1994-03-14  |  4KB  |  106 lines
  1.  
  2.                GNU UTILITIES README
  3.                  (updated 2/16/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.     fsf        Original FSF archives from which the "amiga"
  23.             source tree was derived.
  24.  
  25.     diffs        The patch files that were applied to sources
  26.             in the "fsf" subtree (once dearchived) to
  27.             generate the sources in the "amiga" subtree.
  28.             These are applied with "patch -p1 ...".
  29.  
  30.     build        Files which are created by the configuration
  31.             process, possibly after some hand hacking to
  32.             account for necessary changes that are not yet
  33.             supported by the standard configuration process.
  34.             When configure works properly for this utility,
  35.             the corresponding subtree here will go away.
  36.     
  37. Eventually I hope to make it possible to configure and build an entire
  38. Amiga distribution from the top level of a build tree located somewhere
  39. else, doing nothing more complicated than:
  40.  
  41.     makedir build:junk
  42.     cd build:junk
  43.     FreshFish-XXX:gnu/src/amiga/configure amigados
  44.     make
  45.  
  46. The Cygnus configure makes this a pretty painless operation, however each
  47. of the individual tool needs various amounts of hacking to make this work
  48. correctly.  I haven't had time yet to do this, but hope to get to it in the
  49. future.
  50.  
  51. For now, I've settled on a structure that keeps the source code as pristine
  52. as possible, so that a simple diff -rc against the FSF baseline
  53. distribution for a particular tool will generate the most useful
  54. information, and not include random files that are generated at build time.
  55.  
  56.  
  57. GNU C COMPILER versus OTHER C COMPILERS
  58. ---------------------------------------
  59.  
  60. There are many ports of various GNU utilities which have been compiled with
  61. a compiler other than gcc (compiled with SAS C or Dice for example).  It
  62. was tempting to just include them "as is", however I've generally resisted
  63. that temptation, prefering instead to compile my own binaries using the GNU
  64. C compiler.
  65.  
  66. In many cases, compilation with the GNU C compiler has minimized the source
  67. changes required to produce a binary, thanks to Markus Wild's excellent
  68. Unix emulation environment.  However it is likely that it has introduced
  69. bugs in the process, since it was not always easy to tell which changes
  70. made to a piece of code compiled with another compiler were dependent on
  71. that compiler (and thus not wanted or needed for gcc compilation), or
  72. dependent on AmigaDOS as the host machine (probably needed regardless of
  73. the compiler).  The authors of various ports of GNU utilities have not
  74. always been careful about how they made their changes or how they marked
  75. them in the source code, assuming they even made the source code available
  76. in the first place.
  77.  
  78. So, it is likely that the first few releases of these utilities may be
  79. somewhat fragile.  Since I think it is an important goal of this distri-
  80. bution that eventually all of the supplied GNU source be stable when
  81. compiled with the supplied GNU C compiler (and as much non-GNU source as
  82. possible as well), rather than a random selection of C compilers that may
  83. not be available to the person using this distribution, I think it is worth
  84. the temporary aggravation of stumbling over bugs resulting from a not quite
  85. completed port.
  86.  
  87. When you find a problem that is specific to the Amiga port, please try to
  88. identify it's source, and even better, provide a suggested fix to the
  89. supplied source code.
  90.  
  91. I will be making a serious effort to see that the Amiga specific patches
  92. made to this source tree get folded back into the FSF distributions so that
  93. eventually the source trees will converge, and it will be possible to build
  94. a complete set of GNU tools from unchanged FSF source.  This is the ideal,
  95. it may not be possible to achieve in practice, though I think it is a
  96. worthy goal.
  97.  
  98. LIBM and PDKSH
  99. --------------
  100.  
  101. The src/amiga/libm material is from a BSD distribution, and src/amiga/pdksh
  102. is a ksh compatible shell.  Neither are GNU code, but they are included here
  103. because of their relative importance for use with the other GNU material.
  104.  
  105. -Fred Fish  ><>
  106.