summaryrefslogtreecommitdiff
path: root/games/xroar/xroar.pod
blob: a01e29cd8b7c167fa3243ed4538d10791aea42f7 (plain)
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
# pod source for xroar man page. convert with:
# pod2man --stderr -s6 -r0.32 -u -cSlackBuilds.org xroar.pod > xroar.6

=head1 NAME

xroar - Dragon and CoCo 1/2 emulator.

=head1 SYNOPSIS

xroar [-c CONFFILE] [OPTION]...

=head1 DESCRIPTION

XRoar is a Dragon emulator.  Due to hardware similarities, XRoar also emulates the Tandy Colour Computer
(CoCo) models 1 & 2.

This man page just documents the command-line options to xroar. For full documentation,  see the info page for
xroar, or the HTML documentation in /usr/doc/xroar-_VERSION_/xroar.html.

=head1 OPTIONS

=over 5

=item -c CONFFILE

specify a configuration file

=item Machines

=item -default-machine NAME

default machine on startup

=item -machine NAME

configure named machine (B<-machine help> for list)

=item -machine-desc TEXT

machine description

=item -machine-arch ARCH

machine architecture (B<-machine-arch help> for list)

=item -machine-keyboard LAYOUT

keyboard layout (B<-machine-keyboard> help for list)

=item -machine-cpu CPU

machine CPU (B<-machine-cpu help> for list)

=item -bas NAME

BASIC ROM to use (CoCo only)

=item -extbas NAME

Extended BASIC ROM to use

=item -altbas NAME

64K mode Extended BASIC ROM (Dragon 64)

=item -nobas

disable BASIC

=item -noextbas

disable Extended BASIC

=item -noaltbas

disable 64K mode Extended BASIC

=item -ext-charset NAME

external character generator ROM to use

=item -tv-type TYPE

TV type (B<-tv-type help> for list)

=item -vdg-type TYPE

VDG type (6847 or 6847t1)

=item -ram KBYTES

amount of RAM in K

=item -machine-cart NAME

default cartridge for selected machine

=item -nodos

don't automatically pick a DOS cartridge

=item Cartridges

=item -cart NAME

configure named cartridge (B<-cart help> for list)

=item -cart-desc TEXT

cartridge description

=item -cart-type TYPE

cartridge base type (B<-cart-type help> for list)

=item -cart-rom NAME

ROM image to load ($C000-)

=item -cart-rom2 NAME

second ROM image to load ($E000-)

=item -cart-autorun

autorun cartridge

=item -cart-becker

enable becker port where supported

=item Becker port

=item -becker

prefer becker-enabled DOS (when picked automatically)

=item -becker-ip ADDRESS

address or hostname of DriveWire server [127.0.0.1]

=item -becker-port PORT

port of DriveWire server [65504]

=item Files

=item -load FILENAME

load or attach FILENAME

=item -run FILENAME

load or attach FILENAME and attempt autorun

=item Cassettes

=item -tape-write FILENAME

open FILENAME for tape writing

=item -no-tape-fast

disable fast tape loading

=item -tape-pad

force tape leader padding

=item -no-tape-pad-auto

disable automatic leader padding

=item -tape-rewrite

enable tape rewriting

=item Disks

=item -disk-write-back

default to enabling write-back for disk images

=item -no-disk-auto-os9

don't try to detect headerless OS-9 JVC disk images

=item Firmware ROM images

=item -rompath PATH

ROM search path (colon-separated list)

=item -romlist NAME=LIST

define a ROM list

=item -romlist-print

print defined ROM lists

=item -crclist NAME=LIST

define a ROM CRC list

=item -crclist-print

print defined ROM CRC lists

=item -force-crc-match

force per-architecture CRC matches

=item User interface

=item -ui MODULE

user-interface module (B<-ui help> for list)

=item Video

=item -vo MODULE

video module (B<-vo help> for list)

=item -fs

start emulator full-screen if possible

=item -fskip FRAMES

frameskip (default: 0)

=item -ccr RENDERER

cross-colour renderer (B<-ccr help> for list)

=item -geometry WxH+X+Y

initial emulator geometry

=item -invert-text

start with text mode inverted

=item Audio

=item -ao MODULE

audio module (B<-ao help> for list)

=item -ao-device STRING

device to use for audio module

=item -ao-format FMT

set audio sample format (B<-ao-format help> for list)

=item -ao-rate HZ

set audio frame rate (if supported by module)

=item -ao-channels N

set number of audio channels, 1 or 2

=item -ao-fragments N

set number of audio fragments

=item -ao-fragment-ms MS

set audio fragment size in ms (if supported)

=item -ao-fragment-frames N

set audio fragment size in samples (if supported)

=item -ao-buffer-ms MS

set total audio buffer size in ms (if supported)

=item -ao-buffer-frames N

set total audio buffer size in samples (if supported)

=item -volume VOLUME

audio volume (0 - 100)

=item -fast-sound

faster but less accurate sound

=item Keyboard

=item -keymap CODE

host keyboard type (B<-keymap help> for list)

=item -kbd-translate

enable keyboard translation

=item -type STRING

intercept ROM calls to type STRING into BASIC

=item Joysticks

See JOYSTICK SPECS below for the description of the SPEC arguments.

=item -joy NAME

configure named joystick (B<-joy help> for list)

=item -joy-desc TEXT

joystick description

=item -joy-axis AXIS=SPEC

configure joystick axis

=item -joy-button BTN=SPEC

configure joystick button

=item -joy-right NAME

map right joystick

=item -joy-left NAME

map left joystick

=item -joy-virtual NAME

specify the `virtual' joystick to cycle [kjoy0]

=item Printing

=item -lp-file FILENAME

append Dragon printer output to FILENAME

=item -lp-pipe COMMAND

pipe Dragon printer output to COMMAND

=item Debugging

=item -gdb

disable GDB target

=item -gdb-ip

address of interface for GDB target [localhost]

=item -gdb-port

port for GDB target to listen on [65520]

=item -trace

start with trace mode on

=item -debug-ui FLAGS

UI debugging (see manual, or -1 for all)

=item -debug-file FLAGS

file debugging (see manual, or -1 for all)

=item -debug-fdc FLAGS

FDC debugging (see manual, or -1 for all)

=item -debug-gdb FLAGS

GDB target debugging (see manual, or -1 for all)

=item -v, verbose LEVEL

general debug verbosity (0-3) [1]

=item -q, --quiet

equivalent to --verbose 0

=item -timeout SECONDS

run for SECONDS then quit

=back

=head1 Other options

=over 5

=item -config-print

print full configuration to standard output

=item -h, --help

display this help and exit

=item -V, --version

output version information and exit

=back

=head1 JOYSTICK SPECS

Joystick SPECs are of the form [INTERFACE:][ARG[,ARG]...], from:

	INTERFACE       Axis ARGs                       Button ARGs

	physical        joystick-index,[-]axis-index    joystick-index,button-index
	keyboard        key-name0,key-name1             key-name
	mouse           screen-offset0,screen-offset1   button-number

For physical joysticks a `-' before the axis index inverts the axis.  AXIS 0 is the X-axis, and AXIS 1 the
Y-axis.  BTN 0 is the only one used so far, but in the future BTN 1 will be the second button on certain CoCo
joysticks.

=head1 COPYRIGHT

xroar is Copyright (c) 2009 Ciaran Anscomb

This man page written by B. Watson for the SlackBuilds.org project (but it may be used by anyone).

This is free software.  You may redistribute copies of it under the terms of the GNU General Public License
<http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY, to the extent permitted by law.

=head1 SEE ALSO

The info page for xroar (includes much information not found in this man page).

http://en.wikipedia.org/wiki/TRS-80_Color_Computer

http://archive.worldofdragon.org/index.php?title=Main_Page

http://archive.worldofdragon.org/archive/index.php