1 files changed, 449 insertions, 0 deletions
diff --git a/games/xroar/xroar.pod b/games/xroar/xroar.pod
new file mode 100644
index 0000000000..a01e29cd8b
--- /dev/null
+++ b/games/xroar/xroar.pod
@@ -0,0 +1,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