Update the readme to reflect the new build environment.

This commit is contained in:
Jeremy Rand 2017-09-11 23:28:36 -04:00
parent cbb6cfc1d9
commit 616cfc5f11
2 changed files with 6 additions and 29 deletions

View File

@ -5,36 +5,13 @@ The "Ass-Backward Calculator" for the Apple //GS - an RPN calculator NDA
[Download a disk image](https://github.com/jeremysrand/abCalc/releases/download/v1.0.1/abCalc.2mg) or [download a SHK file](https://github.com/jeremysrand/abCalc/releases/download/v1.0.1/abCalc.SHK)
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:
The source code is built using my [Apple //GS Build Pipeline](https://github.com/jeremysrand/Apple2GSBuildPipeline).
If you setup all of the prerequisites on that project, you should be able to build this on a Mac
using Xcode. Failing that, put the source onto a real or emulated GS and build it using ORCA/C.
However, I no longer have a GS compatible Makefile. If you look in the git history, you will see that
in the past, the build could be done using dmake under GNO/ME on a GS.
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:
The abCalc binary is a shell command you can use from GNO/ME:
![abCalc Shell Screenshot](/abCalc/screenshots/abCalc.png "abCalc Shell Screenshot")