Move to the new build environment

README.md

@@ -0,0 +1,41 @@
+abCalc
+======
+
+The "Ass-Backward Calculator" for the Apple //GS - an RPN calculator NDA
+
+The source can be built both from Mac OSX, resulting in a commandline binary which you can run on a Mac and from a //GS.
+To build and execute on a Mac:
+
+1. Make sure you have Xcode installed.  If not, grab it from the Mac App store.
+2. Execute "make -f Make.mac"
+3. Run "./abCalc"
+
+In theory, it should work on any POSIX platform like Linux, Solaris, etc but I have not tested it on any other platforms.
+
+To build this on a //GS, you need a number of prerequisites:
+
+1. Orca/C v2.0.1
+2. GNO/ME v2.x
+3. occ - the Orca/C wrapper
+4. dmake
+
+To build this on a //GS, the steps are:
+
+1. Somehow copy the files to your //GS.  Depending on whether you are using a real machine or an emulator, your
+approach here may be different.
+2. Find this line in your ORCACDefs/scrap.h file:
+    extern pascal void PutScrap(unsigned Longint, Word, Pointer) inline(0x0C16,dispatcher);
+and change it to
+    extern pascal void PutScrap(LongWord, Word, Pointer) inline(0x0C16,dispatcher);
+This is a bug in the headers which causes ORCA/C to generate the wrong output.
+3. Once you have the files, you should first execute "dmake fixfiles".  This makes sure all files have the right
+file types.
+4. Execute "dmake"
+
+When done, you will have two binaries.  The abCalc binary is a shell command you can use from GNO/ME:
+
+![abCalc Shell Screenshot](/screenshots/abCalc.png "abCalc Shell Screenshot")
+
+And abCalcNDA is a new desk accessory which you can use from within GS/OS applications:
+
+![abCalc NDA Screenshot](/screenshots/abCalcNDA.png "abCalc NDA Screenshot")