Apple-2-SW/EightBall
1
0
Fork 0
mirror of https://github.com/bobbimanners/EightBall.git synced 2024-06-08 07:29:34 +00:00
Code Issues Projects Releases Wiki Activity

Improved description of the project.

Browse Source
This commit is contained in:
Bobbi Webber-Manners 2018-05-01 16:43:11 -04:00 committed by GitHub
parent e3300c496c
commit 567edfa382
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
README.md
View File

@ -1,4 +1,4 @@
# The Eight Bit Algorithmic Language for Apple II, Commodore 64 and VIC 20
# The Eight Bit Algorithmic Language
![picture](https://upload.wikimedia.org/wikipedia/commons/7/78/8_ball_face.jpg)
@ -30,7 +30,7 @@ Includes:
# Intro
## What is EightBall?
EightBall is an interpreter for a novel structured programming language. It runs on a number of 6502-based vintage systems and may also be compiled as a 32 bit Linux executable.
EightBall is an interpreter and bytecode compiler for a novel structured programming language. It runs on a number of 6502-based vintage systems and may also be compiled as a 32 bit Linux executable. The system also includes a simple line editor and the EightBall Virtual Machine, which runs the bytecode generated by the compiler.
## Design Philosophy
EightBall tries to form a balance of the following qualities, in 20K or so of 6502 code:
@ -43,9 +43,10 @@ EightBall tries to form a balance of the following qualities, in 20K or so of 65
## Supported Systems
The following 6502-based systems are currently supported:
* Apple II - EightBall runs under ProDOS and uses upper/lowercase text. It should run on 64K Apple IIe, IIc or IIgs. It can probably run on Apple II/II+ with an 80 column code, but this has not been tested.
* Apple II - EightBall runs under ProDOS and uses upper/lowercase text. It should run on 64K Apple IIe, IIc or IIgs. It can probably run on Apple II/II+ with an 80 column card, but this has not been tested.
* Commodore 64 - EightBall should run on any C64.
* Commodore VIC-20 - EightBall runs on a VIC-20 with 32K of additional RAM.
* Linux - EightBall also runs on Linux.
## Licence
Free Software licenced under GPL v3.
@ -62,7 +63,6 @@ Disk images:
- test.d64 - Commodore 1541 disk images with EightBall for VIC20 and C64.
## Apple II
I used ADTPro to copy `test.dsk` to a real Disk II 140K floppy. A solid state drive such as CFFA3000 should also work.
It is also possible to run the EightBall system using the MAME Apple II emulation under Linux.
@ -82,7 +82,6 @@ The compiled code is written to the file `bytecode` on the floppy diskette conta
If you then invoke the EightBall Virtual Machine `EBVM.SYSTEM`, it will load and execute this bytecode. The VM is much faster than the interpreter.
## Commodore 64
For the Commodore 64, the file `test.d64` can be written to a real C1541 floppy, or to a solid state drive such as SD2IEC.
It is also possible to run the EightBall system using the Vice C64 emulator under Linux.
@ -110,7 +109,6 @@ RUN
```
## VIC 20
For the Commodore VIC20 (plus 32K expansion RAM), the file `test.d64` can be written to a real C1541 floppy, or to a solid state drive such as SD2IEC.
It is also possible to run the EightBall system using the Vice VIC20 emulator under Linux.
@ -138,7 +136,6 @@ RUN
```
## Simple Test Program
Here is a simple test program you can enter to play with EightBall when getting started:
```