Added OS/2 compile instructions

git-svn-id: svn://svn.cc65.org/cc65/trunk@591 b7a2c559-68d2-44c3-8de9-860c34a00d81

diff --git a/doc/compile.txt b/doc/compile.txt
index f62f315349502894fbdfdd513e66c7a4d8ad6751..30a2cf7c7a6055fe7fb9eeb69b006f845f493da5 100644 (file)
--- a/doc/compile.txt
+++ b/doc/compile.txt
@@ -18,17 +18,19 @@ to remove debugging information from the binaries.
 
 After that, you need to compile the libraries. Do
 
-       cd libsrc
-       make clean atarilib
-       make clean c64lib
-       make clean c128lib
-       make clean plus4lib
-       make clean cbm610lib
-       make clean petlib
-       make clean apple2lib
+       cd libsrc; make
 
-Be sure to say "clean" each time, since some of the sources have a
-"#ifdef <target_system>".
+That's it! Installation directories for the RPM packages are
+
+       /usr/bin                for the binaries
+       /usr/lib/cc65/include   for include files
+       /usr/lib/cc65/lib       for libraries and startup files
+
+When using these directories, you don't need to set the CC65_INC and
+CC65_LIB environment variables. You may also use the /usr/local tree
+for installation, but the compiler and linker have no predefined search
+path for this directory, so you need the environment variables or
+change the search paths in the source.
 
 
 
@@ -136,6 +138,114 @@ PATH=E:\djgpp_v2\cc65\binutils;%PATH%
 -------------------------------------------------------------------------
 
 
+OS/2 using the EMX compiler
+---------------------------
+
+If you're using OS/2 and have the EMX compiler and some GNU tools
+installed, you may also be able to compile the tools and libraries
+under OS/2. Mirco Miranda (mircomir@libero.it) sent me the following
+notes:
+
+
+-------------------------------------------------------------------------
+
+CC65 make facilities V0.3 for OS/2 by Mirco Miranda
+Date: 02/01/2000
+
+OS2HOWTO.TXT... I wrote this very fast... I hope that you can
+understand...
+
+Emx is a porting of gcc under OS/2. I wrote some C code that with
+simply (and few) preprocessor line can be compiled under OS/2 and Linux.
+Now for emx there are projects like P2 that let's add to OS/2 a complete
+Posix.1/SUS-like environment... I think that in the future the porting
+from bsd unix (and I hope linux) environment can be made very easy...
+
+These are the things because I tried to compile CC65 with emx/gcc...
+
+WARNING: at time that as wrote compiling with emx/gcc give some warnings.
+
+
+1. What do you need
+-------------------
+
+- emx/gcc 0.9D for OS/2
+
+http://hobbes.nmsu.edu/cgi-bin/h-browse?sh=1&dir=/pub/os2/dev/emx/v0.9d
+
+- gnu make
+
+http://hobbes.nmsu.edu/pub/os2/dev/util/gnumake.zip
+
+- bash
+
+Use (ba)sh coming with this package.
+There are many porting of unix shell for OS/2 and some don't
+work propely.
+
+- and finally the source package of the CC65
+  http://www.cc65.org/#Download
+  http://www.acc.umu.se/~arvid/cc65_mirror/cc65-sources-2.6.0.tar.gz
+
+I hope that's all! I have the complete emx/gnu tools installed on
+my OS/2 and I haven't test if you need other package. Sorry.
+
+
+2. Setup environment in OS/2
+----------------------------
+
+Unpack source package in a Directory and
+copy the files in src directory of source code.
+
+Install emx 0.9D following the istruction comes with it.
+Emx is well documented and I don't rewrite here emx documentation.
+
+Unpack the gnu make tool and copy make-os2.exe in ...\emx\gnu directory
+then rename it in make.exe
+
+Copy xxsh.exe in ...\emx\gnu directory
+
+
+If you want use my .cmd script (makeos2emx.cmd):
+
+- copy it in src directory
+- edit it and change the emx path(s) according with your(s).
+  (set MYEMXPATH=c:\appos2\emx)
+
+else
+
+- add ...\emx\gnu directory on your libpath
+- add ...\emx\gnu directiry on your path
+- set comspec=...\emx\gnu\xxsh.exe
+- run make -f make/gcc.mak in src directory
+- run make in libsrc directory
+
+3. My make files
+----------------
+
+If you use zap command, *.exe are not deleted.
+
+
+4. Author & Disclaimer
+----------------------
+
+Mirco Miranda
+mircomir@libero.it
+ICQ#: 51640305
+
+I haven't tested the generated code of cc65 executables with emx/gcc...
+If you use the cc65 executables compiled with emx/gcc to compile the library,
+please test it before hardly or productivity using.
+
+Safety solution is compile the cc65 executables with Watcom and then
+compile the library using gnu make and gnu (ba)sh coming with this package.
+If you use this last solution you must have only installed emx runtime because
+make.exe and xxsh.exe use it!
+
+-------------------------------------------------------------------------
+
+
+
 DOS, Windows, OS/2 using the Watcom Compiler
 --------------------------------------------
 
@@ -157,3 +267,4 @@ Watcom tools, or you have to change the makefile.
    the one above, or rewrite the makefile.
 
 
+