Apple-2-SW/a2d
1
0
Fork 0
mirror of https://github.com/mi57730/a2d.git synced 2024-11-29 07:49:20 +00:00
Code Issues Projects Releases Wiki Activity

Docs update

Browse Source
This commit is contained in:
Joshua Bell 2017-09-07 08:34:45 -07:00
parent 4a748f7306
commit 8d336c5881
1 changed files with 42 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
desk.acc/README.md
View File

@ -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