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 Delorieand the GNU folks for the original software.  MetaMorph
  46. is a group of software developers who will write software or consult
  47. for NeXTSTEP, UNIX, Linux, DOS, Windows, Windows-NT, and OS/2.
  48. Please email info@metamorph.com for more information.
  49.  
  50. How?
  51. To install:
  52.     1) gunzip and untar the distribution to somplace (say /usr/local/lib)
  53.     2) Place [dir]/djgpp/makefile.djgpp in /usr/local/lib
  54.     3) Edit /usr/local/lib/makefile.djgpp and set DJGPP_DIR to point to
  55.        the djgpp directory (this is not necessary if you placed djgpp
  56.        in /usr/local/lib).
  57.     3) Make sure that gnu make ([dir]/djgpp/gmake) is in your path.
  58.     4) Place go32.exe on your PC (Optional provided you have the proper
  59.        version of go32.exe on the PC already).
  60.     5) See the example in [dir]/djgpp/example
  61.  
  62. *Important*:  You must use the same version of go32 as djgpp!  If
  63. you don't and you have interupt handlers they will not shut down
  64. properly due to some odd  interaction between the old go32 and the
  65. new compiler.  We have included the proper version of go32.exe.
  66.  
  67. ***How to use djgpp (relatively) painlessly under NeXTSTEP***:
  68.    1) In your makefile:
  69.      After all your definitions, but before any targets add the line
  70.          include /usr/local/lib/makefile.djgpp
  71.      This will redefine CC, CFLAGS and LFLAGS to use djgpp.
  72.      You must use these definitions or manually add the code contained
  73.      in makefile.djgpp to your makefile.
  74.      You must have both the CFLAGS and the LFLAGS in your link target.
  75.      If you want to use "specs", setenv LIBRARY_PATH [dir]/djgpp/lib   
  76.    2) You can invoke coff2exe by adding the line
  77.      $(COFF2EXE) $(OUTPUT_NAME)
  78.      this will create $(OUTPUT_NAME).exe
  79.    3) After you have created an executable you can run it under DOS
  80.      provided you ensure that go32.exe is in your path (a copy of
  81.      go32.exe is provided in [dir]/djgpp/bin).
  82.        
  83. To build: use the make.djgpp.sh script.  To do a fresh port or for
  84. help building: see CHANGELOG in [dir]/djgpp/src provided you grabbed
  85. the  djgpp.NS.src.tar.gz file.
  86.  
  87.  
  88. Misc notes:
  89.     gcc, ld and gas are compiled with -O2 and have been stripped.
  90.  
  91.     You will get the following error if you do not use GNU make:
  92.     gcc: installation problem, cannot exec cpp: No such file or directory
  93.  
  94. This software is distributed under the FSF license as a public  service.
  95. The authors offer no warranty or guarantee of any type.
  96.  
  97.