home *** CD-ROM | disk | FTP | other *** search
/ Big Green CD 8 / BGCD_8_Dev.iso / NEXTSTEP / UNIX / GNU / gcc-2.7.2-MIHS / gcc-libs.2.7.2.3.2.README < prev    next >
Encoding:
Text File  |  1998-04-26  |  6.2 KB  |  190 lines
  1. gcc.2.7.2.3.2.README
  2. (aka gcc-m68k.2.7.2.3.2.README)
  3. (aka gcc-m68k.2.7.2.3.2.README)
  4. (aka gcc-libs.2.7.2.3.2.README)
  5. April 21, 1998
  6.  
  7. These packages are so interrelated, this single README is for them all.
  8.  
  9. file:    gcc-m68k.2.7.2.3.2.NI.b.tar.gz
  10. desc:    gcc tools for m68k target binaries, Installer package 
  11. sum:      61797  4659
  12. md5sum:    6daea8a17162d8b9c22a9f03db4391bc
  13.  
  14. file:    gcc-i386.2.7.2.3.2.NI.b.tar.gz
  15. desc:    gcc tools for i386 target binaries, Installer package 
  16. sum:      18510  4652
  17. md5sum:    9be12e906c56fc2fd9fe97b0fce5ff59
  18.  
  19. file:    gcc-libs.2.7.2.3.2.NI.b.tar.gz
  20. desc:    gcc target libs, Installer package
  21. sum:      10945  2503
  22. md5sum:    db0dc8a69d7fe4134e4a928d6c85d510
  23.  
  24. (**
  25.  To be placed at:
  26.   http://www.peak.org/next/apps/devtools/
  27.   ftp://next-ftp.peak.org/pub/next/apps/devtools/
  28. **)
  29.  
  30. These archives contain the following pre-built binaries/libs: 
  31. gcc-2.7.2.3
  32. g77-0.5.22
  33. libg++-2.7.2
  34.  
  35. built on and for the 
  36. m68k-next-nextstep3
  37. i386-next-nextstep3 
  38. platforms. Includes drivers for output targets for each platform, ie,
  39. you can produce both m68k and i386 binaries on/for both platforms.
  40.  
  41.  
  42. NOTES
  43.  
  44. Regarding the versioning of this package:  I tacked on my port
  45. attempt numbers to the end of the gcc versions, ie, This represents
  46. my second (.2) attempt at porting gcc v2.7.2.3 to NEXTSTEP.
  47.  
  48. These packages have been built for and tested on NEXTSTEP 3.3, but
  49. may also work on other versions of NEXTSTEP 3.x.
  50.  
  51. This build CAN (but doesn't, by default) work on OpenStep for Mach
  52. 4.x, provided you have at your disposal a few of the binaries and
  53. libraries from the DeveloperTools package from NEXTSTEP 3.3.  See
  54. USING GCC ON OPENSTEP for details.
  55.  
  56.  
  57. INSTALLATION
  58.  
  59. I've split the distribution into 3 logical parts (since it IS so
  60. big), gcc-m68k, gcc-i386, and gcc-libs.  A full installation
  61. includes: 1) gcc-m68k and/or gcc-i386, depending on the binaries
  62. you wish to create; 2) gcc-libs.  gcc-m68k/gcc-i386 contains
  63. (primarily) the gcc binaries, so these probably should be installed
  64. thin for your native architecture only.  gcc-libs contains the
  65. headers and libraries used to create the target libraries, so if
  66. you want the capability to cross compile, install this fat (m68k+i386).
  67.  
  68. To install the pkg archives, use Installer.app to install to
  69. /usr/local.
  70.  
  71. NOTE: you STILL need the nextstep developer packages (tested for
  72. NEXTSTEP 3.3 only... earlier/other versions may or may not work)
  73. installed in order to use this, as it uses NeXT's supplied C header
  74. files and libraries.  Also, in order to build non-native binaries,
  75. you need the DeveloperLibs installed for that other platform too.
  76.  
  77.  
  78. ENVOCATION AND CROSS-COMPILING
  79.  
  80. To create m68k binaries envoke the compiler as:
  81. m68k-next-nextstep3-gcc foo.c
  82. (or, alternatively, gcc-ns3 -bm68k-next-nextstep3 foo.c )
  83. To create i386 binaries envoke the compiler as:
  84. i386-next-nextstep3-gcc foo.c
  85. (or, alternatively, gcc-ns3 -bi386-next-nextstep3 foo.c )
  86.  
  87. A shortcut has been provided to create binaries for your native architecture
  88. automatically, if you envoke the compiler as
  89. gcc-ns3 foo.c
  90. or just
  91. gcc foo.c
  92.  
  93. I used the name gcc-ns3 to make life simpler for those using this on 
  94. OpenStep for mach, where gcc, by itself, could possibly represent a 
  95. native nextstep4 (OpenStep for Mach) compiler.  The two are not
  96. compatible and should not be confused with one another.
  97.  
  98.  
  99. USING GCC ON OPENSTEP (for Mach 4.x)
  100.  
  101. So, you want to use this compiler to create NEXTSTEP compatible
  102. binaries, but you have OpenStep for Mach 4.x installed?  Not (much
  103. of) a problem.  The developer environent changed enough between
  104. NEXTSTEP 3.x and OpenStep 4.x, that gcc for NEXTSTEP 3.x won't work
  105. without a few modifications.  Fortunately, these modifications are
  106. minimal.
  107.  
  108. I will note that this distribution of gcc is compatible with a
  109. native nextstep4 or openstep4 compiler.  Differing versions of the
  110. compiler can peacefully coexhist.  The only thing to worry about
  111. is the main gcc binary: /usr/local/bin/gcc (and likewise for g++,
  112. g77).  This package over-writes them, so that envoking 'gcc' will
  113. use this nextstep3 compiler.  If you prefer 'gcc' to be a different
  114. compiler, by default, simply link it (hard or soft) to the appropriate
  115. binary in /usr/local/bin, like:
  116. gcc -> i386-next-nextstep4-gcc
  117. or
  118. gcc -> m68k-next-nextstep3-gcc
  119. Envoking the compiler is a little tricky now too.  This is especially
  120. the case when you have native nextstep4/openstep4 gcc compiler
  121. installed too.  To be safe, you should envoke gcc as gcc-ns3 and
  122. always add the appropriate -b flag to the compiler, like:
  123. gcc-ns3 -bi386-next-nextstep3
  124.  
  125. Furthermore, you need to obtain a few binaries and libraries from
  126. the DeveloperTools package from NEXTSTEP 3.3 (Don't install the
  127. DeveloperTools from NEXTSTEP 3.3 onto an OpenStep system, especially
  128. if you already have the DeveloperTools from OpenStep 4.x installed)
  129. Unfortunately, I can't package this gcc distribution with these
  130. bits and pieces already installed/configured for you.  I CAN tell
  131. you how to do it, however.  The items you need are:
  132.  
  133. Binaries (from /bin/): 
  134. Install these to
  135. /usr/local/m68k-next-nextstep3/bin/
  136. and/or
  137. /usr/local/i386-next-nextstep3/bin/
  138.  
  139. ld    REQUIRED 
  140.     install as ld.nextstep3
  141. as    OPTIONAL (can use OpenStep's as, if you already have it)
  142.     install as as.nextstep3        
  143. ar    OPTIONAL (can use OpenStep's ar, if you already have it)
  144. ranlib    OPTIONAL (can use OpenStep's ranlib, if you already have it)
  145.  
  146. Libraries (from /lib/): ALL REQUIRED
  147. Install these to
  148. /usr/local/m68k-next-nextstep3/lib/
  149. and/or
  150. /usr/local/i386-next-nextstep3/lib/
  151.  
  152. crt0.o
  153. crt1.o
  154. gcrt0.o
  155. gcrt1.o
  156. libsys_s.a
  157. posixcrt0.o
  158.  
  159. Header files (from /usr/include/): OPTIONAL (can use OpenStep's header files)
  160. Install these to 
  161. /usr/local/m68k-next-nextstep3/include/
  162. and/or
  163. /usr/local/i386-next-nextstep3/include/
  164. You'll probably only need the ansi, bsd, and mach include subdirectories.
  165.  
  166.  
  167. CHANGELOG
  168.  
  169. April 20, 1998 (port 2)
  170. - Split distribution into 3 parts: m68k drivers, i386 drivers, target libs.
  171. - Added section: USING ON OPENSTEP
  172. - Add TOOL_INCLUDE + ansi/bsd dirs to include search paths.
  173. - removed objc compiler/runtime.
  174. - Full m68k/i386 distribution.
  175. - update to g77-0.5.22
  176.  
  177.  
  178. CREDITS
  179.  
  180. GNU Software, gcc source
  181. http://www.gnu.ai.mit.edu/
  182.  
  183. Packager
  184. Rex Dieter <rdieter@math.unl.edu>
  185. Computer System Manager 
  186. Universtity of Nebraska-Lincoln  
  187. Department of Mathematics and Statistics 
  188. http://www.math.unl.edu/~rdieter/
  189.  
  190.