Add Travis-CI config, add README

This commit is contained in:
Joshua Bell 2019-10-03 21:36:01 -07:00
parent 0626869e27
commit cd2074c864
7 changed files with 20 additions and 30 deletions

20
README.md Normal file
View File

@ -0,0 +1,20 @@
# ProDOS Drivers
[![Build Status](https://travis-ci.org/a2stuff/prodos-drivers.svg?branch=master)](https://travis-ci.org/a2stuff/prodos-drivers)
The ProDOS operating system for the Apple II executes the first `.SYSTEM` file found in the boot directory on startup. A common pattern is to have the boot directory contain several "driver" files that customize ProDOS by installing drivers for hardware or modify specific parts of the operating system. These include:
* Real-time Clock drivers (e.g. No-Slot Clock, Cricket!, AE DClock, etc)
* RAM Disk drivers (e.g. RamWorks)
* Quit dispatcher/selector (`BYE` routines)
Early versions of these drivers would often invoke a specific file on completion, sometimes user-configurable. The best versions of these drivers simply execute the following `.SYSTEM` file, although this is non-trivial code and often did not work with network drives.
This repository collects several drivers and uses common code to chain to the next `.SYSTEM` file, suporting network drives. An example disk catalog might therefore include:
* `PRODOS` - the operating system
* `NS.CLOCK.SYSTEM` - install No-Slot Clock driver, if present
* `CRICKET.SYSTEM` - install Cricket! driver, if present
* `RAM.DRV.SYSTEM` - install RamWorks RAM disk driver, if present
* `BUHBYE.SYSTEM` - install a customized Quit handler
* `QUIT.SYSTEM` - invoke the Quit handler immediately, as a program selector

View File

@ -1,7 +1,5 @@
# Bird's Better Bye - Disassembly (and improvements)
[![Build Status](https://travis-ci.org/a2stuff/bbb.svg?branch=master)](https://travis-ci.org/a2stuff/bbb)
The ProDOS operating system for the Apple II personal computer line
supported a quit routine (invoked from BASIC with the `BYE` command)
allowing the user to type the name of a system file to invoke once

View File

@ -1,11 +0,0 @@
sudo: enabled
os: osx
language: c
install:
- git clone https://github.com/cc65/cc65 /tmp/cc65 &&
sudo make -C /tmp/cc65 ca65 ld65 avail &&
ca65 --version
script:
- make

View File

@ -1,7 +1,5 @@
# _The Cricket!_ — ProDOS Clock Driver
[![Build Status](https://travis-ci.org/a2stuff/cricket.svg?branch=master)](https://travis-ci.org/a2stuff/cricket)
I acquired a Cricket sound/clock peripheral on eBay. Therefore it is now critical that we have a conforming ProDOS clock driver for it.
> STATUS: Works on my machine!

View File

@ -1,11 +0,0 @@
sudo: enabled
os: osx
language: c
install:
- git clone https://github.com/cc65/cc65 /tmp/cc65 &&
sudo make -C /tmp/cc65 ca65 ld65 avail &&
ca65 --version
script:
- make

View File

@ -1,9 +1,5 @@
# Disassembly of Glen E. Bredon's `RAM.DRV.SYSTEM` for Apple II ProDOS
[![Build Status](https://travis-ci.org/a2stuff/ram.drv.system.svg?branch=master)](https://travis-ci.org/a2stuff/ram.drv.system)
This was started before realizing what the origin of the `RAM.SYSTEM`
found on a MouseDesk 2.0 disk image file was.