mirror of
https://github.com/Ponce/slackbuilds
synced 2024-11-18 22:06:04 +01:00
449 lines
7.1 KiB
Text
449 lines
7.1 KiB
Text
# 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
|