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.