From 91596999759ad95a3a7844d6bfe725e2926b4ff7 Mon Sep 17 00:00:00 2001 From: 4am Date: Thu, 19 Sep 2019 10:47:23 -0400 Subject: [PATCH] Create README.md --- README.md | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 000000000..8e0118207 --- /dev/null +++ b/README.md @@ -0,0 +1,41 @@ +# Is this page for you? + +[Download the latest Total Replay disk image](https://archive.org/details/TotalReplay) at the archive.org home page if you just want to play hundreds of Apple II games. The rest of this page is for developers who want to work with the source code and assemble it themselves. + +# Building the code + +## Mac OS X + +You will need + - [Xcode command line tools](https://www.google.com/search?q=xcode+command+line+tools) + - [ACME](https://sourceforge.net/projects/acme-crossass/) + - [sicklittlemonkey's Cadius fork](https://github.com/sicklittlemonkey/cadius) + - [Python 3](https://www.python.org) + +Then open a terminal window and type + +``` +$ cd 4cade/ +$ make +``` + +If all goes well, the `build/` subdirectory will contain a `4cade.2mg` image which can be mounted in emulators like [OpenEmulator](https://archive.org/details/OpenEmulatorSnapshots) or [Virtual II](http://virtualii.com/). + +## Windows + +You will need + - [ACME](https://sourceforge.net/projects/acme-crossass/) + - [Cadius for Windows](https://www.brutaldeluxe.fr/products/crossdevtools/cadius/) + +(Those tools will need to be added to your command-line PATH.) + +Then open a `CMD.EXE` window and type + +``` +C:\> CD 4CADE +C:\4cade> WINMAKE +``` +If all goes well, the `BUILD\` subdirectory will contain a `4CADE.2MG` image which can be mounted in emulators like [AppleWin](https://github.com/AppleWin/AppleWin). + +## Navigating the code +