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
|
<!--
PC-BASIC documentation
Copyright (c) 2014-2022 Rob Hagemans
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.
http://creativecommons.org/licenses/by-sa/4.0/legalcode
-->
<h2 id="settings">Configuration guide</h2>
<p>
This documentation discusses how to change settings and options for PC-BASIC.
</p>
<h3 id="changing-settings">Changing settings</h3>
<p>
PC-BASIC has a number of settings that change the way it operates.
Settings can be changed by setting options on the command line
or through editing the configuration file.
In either method, the options have the same name and syntax. In what follows, we will often refer to
a particular option setting; remember that you can set this from the command line as well as from the configuration file.
</p>
<h5>Command-line options</h5>
<p>
You can enter command-line options if you start PC-BASIC from your operating system's command prompt, console or terminal
(the <code>C:\></code> prompt on Windows),
by supplying the option with two dashes in front, like so:
</p>
<code class="block"><b>pcbasic <a href="#--preset">--preset</a>=tandy <a href="#--ctrl-c-break">--ctrl-c-break</a>=True</b></code>
<p>
On the command line, you can leave out the expression <code><b>=True</b></code>
that is common in switching options.
Some options have an alternative, short name consisting of a single
letter preceded by a single dash, which you can use on the command line.
You can combine multiple short options with a single dash.
</p>
<h5>Configuration files</h5>
<p>
You can change options by adding or removing lines in your local configuration file,
which can be found in the following location:
</p>
<dl>
<dt>Windows</dt><dd><code>%AppData%\pcbasic-0.0\PCBASIC.INI</code></dd>
<dt>OS X</dt><dd><code>~/Library/Application Support/pcbasic-0.0/PCBASIC.INI</code></dd>
<dt>Linux</dt><dd><code>~/.config/pcbasic-0.0/PCBASIC.INI</code></dd>
</dl>
<p>
Change an option in the configuration file by adding a line in the section named <code>[pcbasic]</code>, like so:
</p>
<code class="block">
[pcbasic]<br/>
<a href="#--preset">preset</a>=tandy<br/>
<a href="#--ctrl-c-break">ctrl-c-break</a>=True
</code>
<p>
You cannot use <a href="#parameters">positional arguments</a> or
the short name of options in the configuration file.
You also cannot leave out the expression <code><b>=True</b></code>.
</p>
<p>
The configuration file should be a text file encoded in ASCII or UTF-8.
</p>
|
