Apple-2-SW/a2d
1
0
Fork 0
mirror of https://github.com/mi57730/a2d.git synced 2024-06-25 21:29:30 +00:00
Code Issues Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Joshua Bell 2018-04-21 08:42:29 -07:00 committed by GitHub
parent bdabadc411
commit b070cf0864
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 28 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
desk.acc/README.md
View File

@ -1,14 +1,15 @@
Disassembly of the desk accessories:
Disassembly of the original desk accessories:
* [Calculator](calculator.s) - complete!
* [Date](date.s) - complete!
* [Puzzle](puzzle.s) - complete!
* [Show Text File](show.text.file.s) - in progress! 95% complete
* [Calculator](calculator.s) - in progress! 99% complete
* [Date](date.s) - in progress! 99% complete
* [Puzzle](puzzle.s) - in progress! 99% complete
* Sort Directory - _not started_
* [Sort Directory](sort.directory.s) - in progress! 40% complete
New desk accessories:
* [Show Image File](show.image.file.s) - complete!
* [This Apple](this.apple.s) - complete!
* [Eyes](eyes.s) - complete!
## Desk Accessory Details
@ -20,7 +21,7 @@ New desk accessories:
## Files
* `Makefile` - cleans/builds targets
* `orig/*.bin` - original binary (type $F1, start $800)
* `orig/*.bin` - original binary (type $F1, auxtype $0640, start $800)
* `*.s` - source (originally generated using da65, now modified)
## Build Instructions
@ -29,7 +30,7 @@ On Unix-like systems (including Mac OS X) `make all` should build
build the desk accessory files (original and new) into `out/`
output with a `.$F1` suffix, representing the $F1 file type required.
For the original DAs, the `.F1` and `.bin` files can be compared
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.
@ -44,7 +45,7 @@ Transfer the `.$F1` files to your Apple (real or virtual) ensuring you:
* 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
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
@ -65,3 +66,22 @@ Tips:
* Press Open-Apple and click on each file in the desired order
* Select Sort Directory from the Apple menu, and verify the order
* Restart
## Package Instructions
To produce a ProDOS disk image with the , install and build the
[Cadius](https://github.com/mach-kernel/cadius) tool:
```
git clone https://github.com/mach-kernel/cadius /tmp/cadius
make -C /tmp/cadius
CADIUS=/tmp/cadius/bin/release/cadius
```
Then from the `desk.acc/` directory, run: `go/package.sh`
This will generate: `desk.acc/out/DeskAccessories.2mg`
Mount this disk image in your emulator, or transfer it to a real floppy
with [ADTPro](http://adtpro.com/), then follow the last steps of the
install instructions above.