Ubuntu Manpage: brandy - a portable BBC BASIC V interpreter

NAME

       brandy - a portable BBC BASIC V interpreter

SYNOPSIS

       brandy         [-help]         [-size SIZE]        [-lib FILENAME]        [-load FILENAME]
       [-path DIRECTORY[,DIRECTORY]...]  [-quit FILENAME] [-chain FILENAME] [-ignore] [FILENAME]

DESCRIPTION

       Brandy is an interpreter for BBC BASIC V,  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.

OPTIONS

-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 10000 bytes and anything below this value will be set
to it. The maximum size is limited only by the environment in which the program is
being run. 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.

-graphics
Start the interpreter with the screen in graphics mode in versions of the program
which support graphics and the screen can be in either text or graphics modes.

-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.

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.

FILES

       brandy                executable

       /usr/share/doc/brandy/examples
                             example BASIC programs

AUTHOR

       David Daniels, with contributions from Darren Salt and Colin Tuckley

REPORTING BUGS

       Report bugs to the bug tracker at http://sourceforge.net/projects/brandy

COPYRIGHT

       Copyright (c) 2000, 2001 David Daniels.  Copyright (c) 2009, 2012 Colin Tuckley.  This  is
       free  software;  see the source for copying conditions. There is NO warranty; not even for
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.