home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / languages / c / djgpp-NS.README < prev    next >
Encoding:
Text File  |  1995-05-08  |  4.0 KB  |  97 lines
  1. Erik Jacobsen    Spring 1995 (jacobsen@metamorph.com)
  2.  
  3. For more information: email info@metamorph.com
  4.  
  5. Readme for the NeXTSTEP port of djgpp.
  6.  
  7. What?
  8. Djgpp is a DOS port of gcc, it is hosted under DOS (actually under
  9. a DOS extender) and produces executables that run under DOS (well,
  10. the extender again).  This is simply a "port" of djgpp that hosts
  11. it under NeXTSTEP (m68k or i386) and yet still produces executables
  12. that run under DOS.
  13.  
  14. djgpp.NS.src.tar.gz - source that compiles under NeXTSTEP 
  15. djgpp.NSi386.tar.gz - binaries for NeXTSTEP Intel only
  16. djgpp.NSm68k.tar.gz - binaries for NeXTSTEP Motorola only
  17.  
  18. The current version is based on gcc 2.6.0.
  19.  
  20. Why?
  21. "Hosting" a port of gcc to DOS under NeXTSTEP seems like a pretty
  22. weird idea, why would one do it?  Because Id Software wanted to be
  23. able to do all their development under NeXTSTEP and they needed a
  24. compiler that would produce DOS executables.  This work is courtesy
  25. of Id Software as they paid for the port.
  26.  
  27. Where?
  28. Submitted to:
  29. ftp://ftp.cs.orst.edu/pub/next/submissions/djgpp.README
  30. ftp://ftp.cs.orst.edu/pub/next/submissions/djgpp.NS.src.tar.gz
  31. ftp://ftp.cs.orst.edu/pub/next/submissions/djgpp.NSm68k.tar.gz
  32. ftp://ftp.cs.orst.edu/pub/next/submissions/djgpp.NSi386.tar.gz
  33.  
  34. It should migrate to:
  35. ftp://ftp.cs.orst.edu/software/NeXT/binaries/proglang/djgpp.README
  36. ftp://ftp.cs.orst.edu/software/NeXT/binaries/proglang/djgpp.NS.src.tar.gz
  37. ftp://ftp.cs.orst.edu/software/NeXT/binaries/proglang/djgpp.NSm68k.tar.gz
  38. ftp://ftp.cs.orst.edu/software/NeXT/binaries/proglang/djgpp.NSi386.tar.gz
  39.  
  40.  
  41. Who?
  42. Thanks to Id Software for financing the port.  Erik Jacobsen
  43. (jacobsen@metamorph.com), David Carley (carley@metamorph.com) and
  44. Craig Peeper (drizzt@metamorph.com) ported the software.  Thanks to 
  45. DJ Delorie
  46. and the GNU folks for the original software.  MetaMorph
  47. is a group of software developers who will write software or consult
  48. for NeXTSTEP, UNIX, Linux, DOS, Windows, Windows-NT, and OS/2.
  49. Please email info@metamorph.com for more information.
  50.  
  51. How?
  52. To install:
  53.     1) gunzip and untar the distribution to somplace (say /usr/local/lib)
  54.     2) Place [dir]/djgpp/makefile.djgpp in /usr/local/lib
  55.     3) Edit /usr/local/lib/makefile.djgpp and set DJGPP_DIR to point to
  56.        the djgpp directory (this is not necessary if you placed djgpp
  57.        in /usr/local/lib).
  58.     3) Make sure that gnu make ([dir]/djgpp/gmake) is in your path.
  59.     4) Place go32.exe on your PC (Optional provided you have the proper
  60.        version of go32.exe on the PC already).
  61.     5) See the example in [dir]/djgpp/example
  62.  
  63. *Important*:  You must use the same version of go32 as djgpp!  If
  64. you don't and you have interupt handlers they will not shut down
  65. properly due to some odd  interaction between the old go32 and the
  66. new compiler.  We have included the proper version of go32.exe.
  67.  
  68. ***How to use djgpp (relatively) painlessly under NeXTSTEP***:
  69.    1) In your makefile:
  70.      After all your definitions, but before any targets add the line
  71.          include /usr/local/lib/makefile.djgpp
  72.      This will redefine CC, CFLAGS and LFLAGS to use djgpp.
  73.      You must use these definitions or manually add the code contained
  74.      in makefile.djgpp to your makefile.
  75.      You must have both the CFLAGS and the LFLAGS in your link target.
  76.      If you want to use "specs", setenv LIBRARY_PATH [dir]/djgpp/lib   
  77.    2) You can invoke coff2exe by adding the line
  78.      $(COFF2EXE) $(OUTPUT_NAME)
  79.      this will create $(OUTPUT_NAME).exe
  80.    3) After you have created an executable you can run it under DOS
  81.      provided you ensure that go32.exe is in your path (a copy of
  82.      go32.exe is provided in [dir]/djgpp/bin).
  83.        
  84. To build: use the make.djgpp.sh script.  To do a fresh port or for
  85. help building: see CHANGELOG in [dir]/djgpp/src provided you grabbed
  86. the  djgpp.NS.src.tar.gz file.
  87.  
  88.  
  89. Misc notes:
  90.     gcc, ld and gas are compiled with -O2 and have been stripped.
  91.  
  92.     You will get the following error if you do not use GNU make:
  93.     gcc: installation problem, cannot exec cpp: No such file or directory
  94.  
  95. This software is distributed under the FSF license as a public  service.
  96. The authors offer no warranty or guarantee of any type.
  97.  
  98.