1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
Matrix Brandy configuration file
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Matrix Brandy now supports the use of a configuration file, which
supports most of the command-line options listed in 'brandy -help'
and additionally some tunables ordinarily set via the SYS command
at run-time.
The location of this configuration is:
RISC OS: <Brandy$Dir>.brandyrc
Windows: %APPDATA%\brandyrc
UNIX/Linux: $HOME/.brandyrc
These are:
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 4294966272
bytes (1K short of 4GB), The size may have a
suffix of 'k', 'm' or 'g' to denote that the size is
in kilobytes, megabytes or gigabytes respectively, 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).
nocheck Don't try to check for new versions of Brandy on
interactive mode startup. This is perhaps useful if
you have a slow internet connection that causes Brandy
to hang for a few seconds on startup as it tries to
check for a new version.
fullscreen (SDL build only) Start Brandy in fullscreen mode.
nofull (SDL build only) Never use fullscreen mode.
swsurface (SDL build only) Use a software SDL surface.
zoom <amount> (SDL build only) Zoom the display window by integer
<amount>, in the range 1-4.
tek (Text-mode 'tbrandy' build only) Enable Tektronics
graphics.
startupmode <mode> (SDL build only) Sets the start-up screen mode.
Any built-in mode can be selected by its mode number.
(See ScreenModes.txt)
path <directory list> 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.
See the section below on FILEPATH$ for more details.
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.
ignore (If strict mode enabled by default) Ignore certain
'unsupported feature' errors.
This option allows some unsupported features that do
not affect the basic running of the program to be
ignored.
strict (If ignore mode enabled by default) The interpreter
will report an error whenever it comes across a
BASIC V/VI feature that it does not support, and
some obvious BASIC program bugs that are ignored by
the Acorn interpreter.
lowercase Allow use of lower-case keywords. Unless LISTO option
is set, LIST will show keywords in uppercase. SAVE
will always save keywords in uppercase.
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.
hex64 Equivalent to SYS"Brandy_Hex64",1.
This controls whether Brandy renders and interprets
Base 16 (Hexadecimal) values as 64-bit.
bitshift64 This controls whether Brandy calculates bit shifts
in 64-bit space. 32-bit space is used when disabled
as per ARM BBC BASIC V/VI.
intusesfloat Equivalent to SYS"Brandy_INTusesFloat",1.
This enables a BB4W/BBCSDL extension that allows INT()
to handle numbers > 2^31-1 by using a float if the
number is out of range for a 32-bit signed integer.
legacyintmaths Equivalent to SYS"Brandy_LegacyIntMaths",1.
This allows integer mathematics to be handled in the
way BBC BASIC 1 to 4 on the Acorn 8-bit machines, and
RISC OS ARM BBC BASIC V, including the rather
questionable wrap-around on integers. RISC OS ARM BBC
BASIC VI, BB4W and BBCSDL do not have this wrap-around
issue and will promote to float when needed.
pseudovarsunsigned Equivalent to SYS"Brandy_PseudovarsUnsigned",1.
Only effective on 32-bit hardware. Toggles whether
memory pseudo-variables (e.g. PAGE, HIMEM etc) return
large positive numbers above &7FFFFFFF.
Each option is to be listed on its own line.
Unrecognised options are silently ignored. A - prefix of any option is
also ignored and also skipped over, so either
-nofull
or
nofull
are equally valid. Similarly, a parameter is separated from its option by
either a single space or a single '=' character.
|
