Updated README

Links! Emoji! YouTube link!
This commit is contained in:
Joshua Bell 2019-04-22 21:23:36 -07:00 committed by GitHub
parent 1e162f3564
commit 4eb5057831
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -2,39 +2,49 @@
[![Build Status](https://travis-ci.org/inexorabletash/a2d.svg?branch=master)](https://travis-ci.org/inexorabletash/a2d)
Work-in-Progress disassembly of Apple II Desktop (a.k.a. MouseDesk)
Work-in-Progress disassembly and enhancements for Apple II Desktop (a.k.a. MouseDesk)
💾 Disk images can be found on the [Releases](https://github.com/inexorabletash/a2d/releases) page 💾
## Background
Apple II Desktop started its life as "MouseDesk" by Version Soft. It
This application 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.
and clones with 128k of memory, utilizing double-hires monochrome graphics
(560x192), an optional mouse, and the ProDOS operating system.
Apple Computer acquired the software and released it - rebranded as
Apple II Desktop - as the initial system software for the Apple IIgs
**Apple II DeskTop** - as the initial
[system software for the Apple IIgs](](http://www.whatisthe2gs.apple2.org.za/system-applications))
before 16-bit GS/OS replaced it. The rebranded version still functions
on 8-bit Apples.
on 8-bit Apples, including the Apple IIe, Apple IIc, Apple IIc Plus,
Apple IIe Option Card for Macintosh, and the Laser 128 family.
Overview: http://toastytech.com/guis/a2desk.html
* [History of MouseDesk/Apple II DeskTop versions, by Jay Edwards](https://mirrors.apple2.org.za/ground.icaen.uiowa.edu/MiscInfo/Misc/mousedesk.info)
* Overviews: [GUI Gallery](http://toastytech.com/guis/a2desk.html) — [GUIdebook](https://guidebookgallery.org/guis/apple2/mousedesk)
* 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”
* [Disk Images](https://mirrors.apple2.org.za/ftp.apple.asimov.net/images/masters/other_os/gui/) for MouseDesk and Apple II DeskTop
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”
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 -
Other GUI environments exist for the 8-bit Apples, including
[GEOS](http://toastytech.com/guis/a2geos.html) (which includes productivity applications) and
[Quark Catalyst](http://toastytech.com/guis/qcat.html).
While Apple II 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
## This Project
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.
with an eye towards understanding how it functions, fixing bugs, and
adding functionality.
See the [Release Notes](RELEASE-NOTES.md) for a list of enhancements and fixes so far.
[![Alt text](https://img.youtube.com/vi/zbElPj5zaBs/0.jpg)](https://www.youtube.com/watch?v=zbElPj5zaBs)
<br>
_KansasFest 2018 presentation by @mgcaret_
Additional help is welcome! See the guide for [Contributing](CONTRIBUTING.md).
## Tools