Disassembly of the Apple II Desktop - ProDOS GUI
Go to file
Joshua Bell 8386ea02d7
Create standardized code of conduct
2018-04-11 21:36:56 -07:00
desk.acc Make mount/ copy optional 2018-04-10 21:25:33 -07:00
desktop travis CI build fix 2018-04-10 21:12:48 -07:00
fonts Fonts! 2018-03-29 07:38:59 -07:00
inc THIS.APPLE DA: empty slots, RamWorks memory 2018-04-05 21:29:25 -07:00
res stats.pl: add 'scoped' command 2018-04-10 17:44:31 -07:00
.gitignore DeskTop: Identify bank-switched routines 2018-01-04 12:58:32 -08:00
.travis.yml travis CI build fix 2018-04-10 21:18:28 -07:00
APIs.md Tighten up MGTK name 2018-02-21 08:06:38 -08:00
CODE_OF_CONDUCT.md Create standardized code of conduct 2018-04-11 21:36:56 -07:00
CONTRIBUTING.md Add suggested project to CONTRIBUTING 2018-04-10 20:36:40 -07:00
CodingStyle.md fix typo 2018-03-27 21:06:44 -07:00
MGTK.md Improved MGTK docs around redrawing and DAs 2018-04-06 08:04:36 -07:00
README.md Add Travis-CI bug to home page 2018-04-10 21:28:29 -07:00
desktop.inc THIS.APPLE DA: Remove some done TODOs, fix III icon link, improve var names 2018-04-06 17:24:07 -07:00
keyboard.md 'solid' apple 2018-02-04 21:05:31 -08:00
macros.inc THIS.APPLE DA: empty slots, RamWorks memory 2018-04-05 21:29:25 -07:00
mgtk.inc MGTK: Keyboard mouse/misc ($17D79..$18431) 2018-04-10 16:26:36 -07:00

README.md

A2D

Build Status

Work-in-Progress disassembly of Apple II Desktop (a.k.a. A2.Desktop)

Background

A2.Desktop started its life as "Mousedesk" by Version Soft, as a mouse-driven Mac-like "Finder" GUI application for 8-bit Apples with 128k of memory (Enhanced Apple //e, Apple //c) using double-hires monochrome graphics (560x192) and the ProDOS operating system.

Although the history is sketchy, it appears that Apple Computer licensed (or acquired) the software, and released it - rebranded as Apple II Desktop - as the initial system software for the Apple IIgs before 16-bit GS/OS replaced it. The rebranded version still functions on 8-bit Apples.

Overview: http://toastytech.com/guis/a2desk.html

Manual: Apple IIgs System Disk Users Guide (1986) - Chapter 2 “The DeskTop”

A pieced-together history, details of versions, bug reports and feature requests: https://mirrors.apple2.org.za/ground.icaen.uiowa.edu/MiscInfo/Misc/mousedesk.info

Disks can be found at: ftp://ftp.apple.asimov.net/pub/apple_II/images/masters/other_os/gui/

Other GUI environments exist for the 8-bit Apples, including GEOS (which includes productivity applications) and Quark Catalyst. While A2.Desktop is more limited - serving only as a file manager and application launcher - it is (subjectively) more visually appealing and better integrated with ProDOS.

Goal

The goal of this project is to disassemble/reverse-engineer the suite with an eye towards understanding how it functions, and eventually fixing bugs and adding functionality.

Tools

The cc65 tool chain will be used; source files will target the ca65 macro assembler. Cross-development on modern systems will be assumed. (Sorry, Merlin purists! We still love you.)

Code of Conduct

Discussions should be polite, respectful and inclusive, and focus on the code. Harassment will not be tolerated. Keep comments constructive.