From 4eb5057831d069199e268820791666706707ef1e Mon Sep 17 00:00:00 2001 From: Joshua Bell Date: Mon, 22 Apr 2019 21:23:36 -0700 Subject: [PATCH] Updated README Links! Emoji! YouTube link! --- README.md | 48 +++++++++++++++++++++++++++++------------------- 1 file changed, 29 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index bcedd0d..6a1eaa0 100644 --- a/README.md +++ b/README.md @@ -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 User’s 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 User’s 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) +
+_KansasFest 2018 presentation by @mgcaret_ + +Additional help is welcome! See the guide for [Contributing](CONTRIBUTING.md). ## Tools