From dd6fb667cfc5e84b38a0f533eeff47c644a20da1 Mon Sep 17 00:00:00 2001 From: Stephen Heumann Date: Tue, 2 May 2017 18:21:42 -0500 Subject: [PATCH] Add build instructions. --- BUILDING.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 BUILDING.md diff --git a/BUILDING.md b/BUILDING.md new file mode 100644 index 0000000..6009717 --- /dev/null +++ b/BUILDING.md @@ -0,0 +1,35 @@ +Building AFPBridge +================== + +AFPBridge is designed to be built under GNO 2.0.6, with ORCA/C and ORCA/M +installed under `/lang/orca` as described in the GNO documentation. +I am using a custom version of ORCA/C with several patches applied, +but I believe a stock version of ORCA/C 2.1.x should also work. + +You also need to get the `AppleTalk.h` header file, which is included +under `Libraries/APWCInclude` in an ORCA/C installation. Copy it either +to `/lang/orca/Libraries/ORCACDefs` or to the directory with the AFPBridge +source files. The original version of that file does not include +prototypes in its function declarations, which will cause an ORCA/C error +with the settings in the makefile. To avoid this, either remove the +`-w` flag from `CFLAGS` in `Makefile.mk`, or add the prototypes in +`AppleTalk.h`. If adding the prototypes, they should be `RamForbid(void)`, +`RamPermit(void)`, and `_CALLAT(void*)`. + +To build AFPBridge using source files copied directly from the Git repository, +first run: + + make import + +This sets the file types appropriately, converts files to Apple II-style +line endings, and generates required assembly-language macro files. + +Once that is done, you can build the code by running: + + make + +This builds the `AFPBridge` init, the `AFPMounter` CDev, and several +command-line utilities that can be useful for testing and debugging. + +You can also run `make install` to install the init and CDev in your +system folder, or `make clean` to remove the generated files.