brandy - a portable BBC BASIC VI interpreter
brandy -help
brandy -version
brandy [
-size <
size>] [
-fullscreen]
[
-swsurface] [
-path <
list>] [
-load
<
file>] [
-chain <
file>] [
-quit
<
file>] [
-lib <
file>] [
-ignore]
[
-- <
options>] [<
file>]
Brandy is an interpreter for
BBC BASIC VI, the dialect of BASIC
that Acorn Computers supplied with their ranges of desktop computers that use
the ARM processor such as the Archimedes and Risc PC, and is still in use on
these and compatibles.
BASIC V is a much extended version of BBC BASIC. This was the BASIC used
on the 6502-based BBC Micro that Acorn made during the 1980s.
- -help
- Print a summary of these options.
-
-size <size>
- Set the size of the Basic workspace to size bytes
when starting the interpreter. The minimum size allowed is 16384 bytes and
anything below this value will be set to it. The maximum size is
2147483644 bytes (4 bytes short of 2GiB). The size may have a suffix of
k to denote that the size is in kilobytes or m if it is in
megabytes. For example, -size 100k will set the workspace size to
100 kilobytes (102400 bytes) and -size 8m will set it to eight
megabytes (8388608 bytes).
-
-lib <filename>
- Load Basic library filename when the interpreter
starts. This option can be repeated as many times as required to load a
number of libraries. This is equivalent to typing INSTALL
filename at the interpreter's command line. The libraries are
loaded in the order given on the command line. Note that the search order
is the reverse of this.
-
-load <filename>
- Load Basic program filename when the interpreter
starts.
-
-path
<directory>[,<directory]...
- This specifies a list of directories that the interpreter
will search when looking for libraries and programs. The directory names
are separated by commas. The pseudo-variable FILEPATH$ is set to
this value.
-
-quit <filename>
- Load and run the Basic program filename. Leave the
interpreter when the program has finished running.
-
-chain <filename>
- Load and run the Basic program filename. Remain in
the interpreter when the program has finished running.
- -ignore
- Ignore certain `unsupported feature' errors. By default the
interpreter reports an error whenever it comes across a BASIC V feature
that it does not support. This option allows some unsupported features
that do not affect the basic running of the program to be ignored.
- <filename>
- This is exactly equivalent to -chain.
- -nostar
- Do not check commands issued via OSCLI to see if
they are dealt with by Brandy. Pass all commands to the underlying
operating system.
The case of the names of the options is ignored. It depends on the operating
system under which the interpreter is running as to whether the names of files
are case sensitive or insensitive.
- /usr/share/doc/brandy
- Full documentation.
- /usr/share/doc/brandy/examples
- Example programs.
David Daniels, with contributions from Darren Salt and Colin Tuckley. Matrix
Brandy modifications by Michael McConnell and contributors.