From 466836b961b54992788f5b5bec0fadd6e3a17e3f Mon Sep 17 00:00:00 2001 From: 4am Date: Mon, 27 Apr 2020 11:36:28 -0400 Subject: [PATCH] Create README.md --- README.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..dc17c3f --- /dev/null +++ b/README.md @@ -0,0 +1,37 @@ +# Is this page for you? + +[Download the latest Pitch Dark disk image](https://archive.org/details/PitchDark) at the archive.org home page if you just want to play text adventures on your Apple II. 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) + +Then open a terminal window and type + +``` +$ cd pitch-dark/ +$ make +``` + +If all goes well, the `build/` subdirectory will contain a `Pitch Dark.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 PITCH-DARK +C:\4cade> WINMAKE +``` +If all goes well, the `BUILD\` subdirectory will contain a `Pitch Dark.2mg` image which can be mounted in emulators like [AppleWin](https://github.com/AppleWin/AppleWin).