a2d/README.md

50 lines
2.1 KiB
Markdown
Raw Normal View History

2018-04-28 03:40:39 +00:00
# Apple II DeskTop
2017-08-29 04:21:31 +00:00
2018-04-11 04:28:29 +00:00
[![Build Status](https://travis-ci.org/inexorabletash/a2d.svg?branch=master)](https://travis-ci.org/inexorabletash/a2d)
2018-04-28 03:40:39 +00:00
Work-in-Progress disassembly of Apple II Desktop (a.k.a. MouseDesk)
2017-08-29 03:58:09 +00:00
2017-08-29 04:21:31 +00:00
## Background
2018-04-28 03:40:39 +00:00
Apple II Desktop started its life as "MouseDesk" by Version Soft. It
is 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.
2017-08-29 04:21:31 +00:00
2018-04-28 03:40:39 +00:00
Apple Computer 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.
2017-08-29 03:58:09 +00:00
2017-09-04 20:57:34 +00:00
Overview: http://toastytech.com/guis/a2desk.html
2017-09-21 16:49:06 +00:00
Manual: [Apple IIgs System Disk Users Guide (1986)](https://mirrors.apple2.org.za/ftp.apple.asimov.net/documentation/misc/Apple%20IIgs%20System%20Disk%20Users%20Guide%20%281986%29.pdf) - Chapter 2 “The DeskTop”
2017-08-29 04:21:31 +00:00
2017-09-21 16:49:06 +00:00
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
2017-08-29 04:21:31 +00:00
Disks can be found at:
2017-08-29 03:58:09 +00:00
ftp://ftp.apple.asimov.net/pub/apple_II/images/masters/other_os/gui/
2017-08-29 04:21:31 +00:00
Other GUI environments exist for the 8-bit Apples, including GEOS (which includes
2017-09-04 20:57:34 +00:00
productivity applications) and Quark Catalyst. While A2.Desktop is more limited -
2017-08-29 04:21:31 +00:00
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](http://cc65.github.io/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.
2018-04-12 04:38:08 +00:00
Please read the full [Code of Conduct](CODE_OF_CONDUCT.md).