diff --git a/README.md b/README.md new file mode 100644 index 0000000..e9063fe --- /dev/null +++ b/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")