kanaka/mal
1
1
Fork 0
mirror of https://github.com/kanaka/mal.git synced 2024-09-11 13:55:55 +03:00
Code Issues Projects Releases Wiki Activity

bbc-basic: README updates.

Browse Source
This commit is contained in:
Ben Harris 2019-05-18 22:53:25 +01:00
parent 6252121a0b
commit 3b18b5b6cc
1 changed files with 45 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
bbc-basic/README.md
View File

@ -6,11 +6,12 @@ directory), it's targeted at much more primitive versions of BASIC and
relies on a pre-processor, both of which make it fairly un-idiomatic
as a BBC BASIC V program.
BBC BASIC V is the version of BBC BASIC supplied with the first
ARM-based computers. It has substantial enhancements from the
6502-based versions of BBC BASIC, which were themselves at the
advanced end of 8-bit BASICs. Mal uses many of the advanced features
of BBC BASIC V and porting it to older versions would be difficult.
BBC BASIC V is the version of BBC BASIC supplied with Acorn's
ARM-based computers from the mid-1980s. It has substantial
enhancements from the 6502-based versions of BBC BASIC, which were
themselves at the advanced end of 8-bit BASICs. Mal uses many of the
advanced features of BBC BASIC V and porting it to older versions
would be difficult.
Mal is intended to run on all versions of BBC BASIC V and BBC BASIC
VI, as well as on Brandy 1.20.1. For compatibility with Brandy, it
@ -18,6 +19,45 @@ avoids operating system calls where possible. The only exception
is that is has separate mechanisms for reading command-line arguments
under Brandy and RISC OS.
# Running under Unix
On Unix systems, this mal implementation can run on the Brandy
interpreter. The tests require the "simple text" build, but mal will
work interactively in graphical builds as well. You can invoke mal
like this:
```
cd bbc-basic
brandy stepA_mal.bbc
```
# Running under RISC OS
To run mal under RISC OS, you obviously need to get the files onto
your RISC OS system, and you also need to arrange to tokenize the
BASIC source files. There are scripts to do the latter in the
`riscos` directory, but they do require that the mal source tree be
available under RISC OS without its filenames' being truncated, which
may restrict with filing systems can be used. The HostFS supplied
with ArcEm works fine.
Once you have the files in RISC OS, you can set things up by running:
```
*Dir bbc-basic.riscos
*Run setup
```
Then you can invoke the interpreter directly:
```
*Run stepA_mal
```
At present, there's no filename translation in the `slurp` function,
so many of the example mal programs will fail because they can't load
`core.mal`.
# Interesting features
This appears to be the first mal implementation that uses an table-driven