NAME

       brandy - a portable BBC BASIC VI interpreter

SYNOPSIS

       brandy -help
       brandy -version
       brandy  [-size  <size>]  [-fullscreen]  [-swsurface] [-path <list>] [-load <file>] [-chain <file>] [-quit
       <file>] [-lib <file>] [-ignore] [-- <options>] [<file>]

DESCRIPTION

       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.

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

SEE ALSO

       /usr/share/doc/brandy
              Full documentation.

       /usr/share/doc/brandy/examples
              Example programs.

AUTHORS

       David  Daniels,  with  contributions  from Darren Salt and Colin Tuckley.  Matrix Brandy modifications by
       Michael McConnell and contributors.

brandy 1.22.12                                     28 Dec 2021                                         BRANDY(1)