From 8d336c58818ea20defe056bfd2e3da19ccf9c545 Mon Sep 17 00:00:00 2001
From: Joshua Bell <inexorabletash@gmail.com>
Date: Thu, 7 Sep 2017 08:34:45 -0700
Subject: [PATCH] Docs update

---
 desk.acc/README.md | 44 ++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 42 insertions(+), 2 deletions(-)

diff --git a/desk.acc/README.md b/desk.acc/README.md
index 602ff63..0e84563 100644
--- a/desk.acc/README.md
+++ b/desk.acc/README.md
@@ -1,13 +1,13 @@
 Disassembly of the desk accessories:
 
-* Calculator - _not started_
+* [Calculator](calculator.s) - in progress!
 * Date - _not started_
 * Puzzle - _not started_
 * [Show Text File](show_text_file.s) - in progress!
 * Sort Directory - _not started_
 
 New desk accessories:
-* [Show DHR File](show_dhr_file.s) - in progress!
+* [Show Image File](show_image_file.s) - complete!
 
 ## Desk Accessory Details
 
@@ -23,3 +23,43 @@ New desk accessories:
 * `*.bin` - original binary (type $F1, start $800)
 * `*.info` - da65 "info" file - used to inform disassembly
 * `*.s` - source (originally generated using da65, now modified)
+
+## Build Instructions
+
+On Unix-like systems (including Mac OS X) `make all` should build
+build the desk accessory files (original and new) and output
+files with a `.f1` suffix, representing the $F1 file type required.
+
+For the original DAs, the `.f1` and `.bin` files can be compared
+using `diff` to ensure that no changes have been introduced by the
+disassembly process.
+
+## Install Instructions
+
+Transfer the `.f1` files to your Apple (real or virtual) ensuring you:
+
+* Drop the suffix
+* Replace `.` in the name with spaces
+* Ensure they have ProDOS file type `$F1`
+* Ensure they have start address `$800`
+
+The last two are tricky, and depend on how you're copying the files.
+My process is to use Virtual ][ on my Mac and mount a folder as a
+ProDOS drive; I copy one of the original DAs into the folder which
+gives it the $F1 filetype as a suffix and start address as an invisible
+resource stream. I then unmount the folder, overwrite the DA with
+a newly built one, and remount the folder.
+
+Finally:
+
+* Drop the files into your `A2.DESKTOP\DESK.ACC` folder
+* Restart so A2D picks up the new DA
+
+Tips:
+
+* You can use the Sort Directory DA to order the files, which controls
+the menu order:
+  * Open the `A2.DESKTOP\DESK.ACC` folder
+  * Press Open-Apple and click on the each file in the desired order
+  * Select Sort Directory from the Apple menu, and verify the order
+  * Restart