diff options
| -rw-r--r-- | games/xroar/doinst.sh | 6 | ||||
| -rw-r--r-- | games/xroar/xroar.6 | 404 | ||||
| -rw-r--r-- | games/xroar/xroar.SlackBuild | 15 | ||||
| -rw-r--r-- | games/xroar/xroar.info | 6 | ||||
| -rw-r--r-- | games/xroar/xroar.pod | 449 |
5 files changed, 653 insertions, 227 deletions
diff --git a/games/xroar/doinst.sh b/games/xroar/doinst.sh index 3e5691a052b5b..5fb28930db0b9 100644 --- a/games/xroar/doinst.sh +++ b/games/xroar/doinst.sh @@ -1,9 +1,3 @@ if [ -x /usr/bin/update-desktop-database ]; then /usr/bin/update-desktop-database -q usr/share/applications >/dev/null 2>&1 fi - -if [ -e usr/share/icons/hicolor/icon-theme.cache ]; then - if [ -x /usr/bin/gtk-update-icon-cache ]; then - /usr/bin/gtk-update-icon-cache usr/share/icons/hicolor >/dev/null 2>&1 - fi -fi diff --git a/games/xroar/xroar.6 b/games/xroar/xroar.6 index 1be7136496b91..dc5a19be7e9a0 100644 --- a/games/xroar/xroar.6 +++ b/games/xroar/xroar.6 @@ -68,72 +68,10 @@ . \} .\} .rr rF -.\" -.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). -.\" Fear. Run. Save yourself. No user-serviceable parts. -. \" fudge factors for nroff and troff -.if n \{\ -. ds #H 0 -. ds #V .8m -. ds #F .3m -. ds #[ \f1 -. ds #] \fP -.\} -.if t \{\ -. ds #H ((1u-(\\\\n(.fu%2u))*.13m) -. ds #V .6m -. ds #F 0 -. ds #[ \& -. ds #] \& -.\} -. \" simple accents for nroff and troff -.if n \{\ -. ds ' \& -. ds ` \& -. ds ^ \& -. ds , \& -. ds ~ ~ -. ds / -.\} -.if t \{\ -. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" -. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' -. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' -. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' -. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' -. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' -.\} -. \" troff and (daisy-wheel) nroff accents -.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' -.ds 8 \h'\*(#H'\(*b\h'-\*(#H' -.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] -.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' -.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' -.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] -.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] -.ds ae a\h'-(\w'a'u*4/10)'e -.ds Ae A\h'-(\w'A'u*4/10)'E -. \" corrections for vroff -.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' -.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' -. \" for low resolution devices (crt and lpr) -.if \n(.H>23 .if \n(.V>19 \ -\{\ -. ds : e -. ds 8 ss -. ds o a -. ds d- d\h'-1'\(ga -. ds D- D\h'-1'\(hy -. ds th \o'bp' -. ds Th \o'LP' -. ds ae ae -. ds Ae AE -.\} -.rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "XROAR 6" -.TH XROAR 6 "2014-03-14" "0.31.1" "SlackBuilds.org" +.TH XROAR 6 "2014-08-24" "0.32" "SlackBuilds.org" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -142,334 +80,366 @@ xroar \- Dragon and CoCo 1/2 emulator. .SH "SYNOPSIS" .IX Header "SYNOPSIS" -\&\fBxroar\fR [\-c \s-1CONFFILE\s0] [\s-1OPTION\s0]... +xroar [\-c \s-1CONFFILE\s0] [\s-1OPTION\s0]... .SH "DESCRIPTION" .IX Header "DESCRIPTION" -XRoar is a Dragon emulator. Due to hardware similarities, XRoar also -emulates the Tandy Colour Computer (CoCo) models 1 & 2. +XRoar is a Dragon emulator. Due to hardware similarities, XRoar also emulates the Tandy Colour Computer +(CoCo) models 1 & 2. .PP -This man page just documents the command-line options to xroar. For full -documentation, see the info page for xroar, or the \s-1HTML\s0 documentation -in /usr/doc/xroar\-_VERSION_/xroar.html. +This man page just documents the command-line options to xroar. For full documentation, see the info page for +xroar, or the \s-1HTML\s0 documentation in /usr/doc/xroar\-_VERSION_/xroar.html. .SH "OPTIONS" .IX Header "OPTIONS" -.IP "\-c \fI\s-1CONFFILE\s0\fR" 4 +.IP "\-c \s-1CONFFILE\s0" 5 .IX Item "-c CONFFILE" specify a configuration file -.SS "Machines" -.IX Subsection "Machines" -.IP "\-default\-machine \fI\s-1NAME\s0\fR" 4 +.IP "Machines" 5 +.IX Item "Machines" +.PD 0 +.IP "\-default\-machine \s-1NAME\s0" 5 .IX Item "-default-machine NAME" +.PD default machine on startup -.IP "\-machine \fI\s-1NAME\s0\fR" 4 +.IP "\-machine \s-1NAME\s0" 5 .IX Item "-machine NAME" -configure named machine (\-machine help for list) -.IP "\-machine\-desc \fI\s-1TEXT\s0\fR" 4 +configure named machine (\fB\-machine help\fR for list) +.IP "\-machine\-desc \s-1TEXT\s0" 5 .IX Item "-machine-desc TEXT" machine description -.IP "\-machine\-arch \fI\s-1ARCH\s0\fR" 4 +.IP "\-machine\-arch \s-1ARCH\s0" 5 .IX Item "-machine-arch ARCH" -machine architecture (\-machine\-arch help for list) -.IP "\-machine\-keyboard \fI\s-1LAYOUT\s0\fR" 4 +machine architecture (\fB\-machine\-arch help\fR for list) +.IP "\-machine\-keyboard \s-1LAYOUT\s0" 5 .IX Item "-machine-keyboard LAYOUT" -keyboard layout (\-machine\-keyboard help for list) -.IP "\-machine\-cpu \fI\s-1CPU\s0\fR" 4 +keyboard layout (\fB\-machine\-keyboard\fR help for list) +.IP "\-machine\-cpu \s-1CPU\s0" 5 .IX Item "-machine-cpu CPU" -machine \s-1CPU \s0(\-machine\-cpu help for list) -.IP "\-bas \fI\s-1NAME\s0\fR" 4 +machine \s-1CPU \s0(\fB\-machine\-cpu help\fR for list) +.IP "\-bas \s-1NAME\s0" 5 .IX Item "-bas NAME" \&\s-1BASIC ROM\s0 to use (CoCo only) -.IP "\-extbas \fI\s-1NAME\s0\fR" 4 +.IP "\-extbas \s-1NAME\s0" 5 .IX Item "-extbas NAME" Extended \s-1BASIC ROM\s0 to use -.IP "\-altbas \fI\s-1NAME\s0\fR" 4 +.IP "\-altbas \s-1NAME\s0" 5 .IX Item "-altbas NAME" 64K mode Extended \s-1BASIC ROM \s0(Dragon 64) -.IP "\-nobas" 4 +.IP "\-nobas" 5 .IX Item "-nobas" disable \s-1BASIC\s0 -.IP "\-noextbas" 4 +.IP "\-noextbas" 5 .IX Item "-noextbas" disable Extended \s-1BASIC\s0 -.IP "\-noaltbas" 4 +.IP "\-noaltbas" 5 .IX Item "-noaltbas" disable 64K mode Extended \s-1BASIC\s0 -.IP "\-ext\-charset \fI\s-1NAME\s0\fR" 4 +.IP "\-ext\-charset \s-1NAME\s0" 5 .IX Item "-ext-charset NAME" external character generator \s-1ROM\s0 to use -.IP "\-tv\-type \fI\s-1TYPE\s0\fR" 4 +.IP "\-tv\-type \s-1TYPE\s0" 5 .IX Item "-tv-type TYPE" -\&\s-1TV\s0 type (\-tv\-type help for list) -.IP "\-vdg\-type \fI\s-1TYPE\s0\fR" 4 +\&\s-1TV\s0 type (\fB\-tv\-type help\fR for list) +.IP "\-vdg\-type \s-1TYPE\s0" 5 .IX Item "-vdg-type TYPE" \&\s-1VDG\s0 type (6847 or 6847t1) -.IP "\-ram \fI\s-1KBYTES\s0\fR" 4 +.IP "\-ram \s-1KBYTES\s0" 5 .IX Item "-ram KBYTES" amount of \s-1RAM\s0 in K -.IP "\-machine\-cart \fI\s-1NAME\s0\fR" 4 +.IP "\-machine\-cart \s-1NAME\s0" 5 .IX Item "-machine-cart NAME" default cartridge for selected machine -.IP "\-nodos" 4 +.IP "\-nodos" 5 .IX Item "-nodos" don't automatically pick a \s-1DOS\s0 cartridge -.SS "Cartridges" -.IX Subsection "Cartridges" -.IP "\-cart \fI\s-1NAME\s0\fR" 4 +.IP "Cartridges" 5 +.IX Item "Cartridges" +.PD 0 +.IP "\-cart \s-1NAME\s0" 5 .IX Item "-cart NAME" -configure named cartridge (\-cart help for list) -.IP "\-cart\-desc \fI\s-1TEXT\s0\fR" 4 +.PD +configure named cartridge (\fB\-cart help\fR for list) +.IP "\-cart\-desc \s-1TEXT\s0" 5 .IX Item "-cart-desc TEXT" cartridge description -.IP "\-cart\-type \fI\s-1TYPE\s0\fR" 4 +.IP "\-cart\-type \s-1TYPE\s0" 5 .IX Item "-cart-type TYPE" -cartridge base type (\-cart\-type help for list) -.IP "\-cart\-rom \fI\s-1NAME\s0\fR" 4 +cartridge base type (\fB\-cart\-type help\fR for list) +.IP "\-cart\-rom \s-1NAME\s0" 5 .IX Item "-cart-rom NAME" \&\s-1ROM\s0 image to load ($C000\-) -.IP "\-cart\-rom2 \fI\s-1NAME\s0\fR" 4 +.IP "\-cart\-rom2 \s-1NAME\s0" 5 .IX Item "-cart-rom2 NAME" second \s-1ROM\s0 image to load ($E000\-) -.IP "\-cart\-autorun" 4 +.IP "\-cart\-autorun" 5 .IX Item "-cart-autorun" autorun cartridge -.IP "\-cart\-becker" 4 +.IP "\-cart\-becker" 5 .IX Item "-cart-becker" enable becker port where supported -.SS "Becker port" -.IX Subsection "Becker port" -.IP "\-becker" 4 +.IP "Becker port" 5 +.IX Item "Becker port" +.PD 0 +.IP "\-becker" 5 .IX Item "-becker" +.PD prefer becker-enabled \s-1DOS \s0(when picked automatically) -.IP "\-becker\-ip \fI\s-1ADDRESS\s0\fR" 4 +.IP "\-becker\-ip \s-1ADDRESS\s0" 5 .IX Item "-becker-ip ADDRESS" address or hostname of DriveWire server [127.0.0.1] -.IP "\-becker\-port \fI\s-1PORT\s0\fR" 4 +.IP "\-becker\-port \s-1PORT\s0" 5 .IX Item "-becker-port PORT" port of DriveWire server [65504] -.SS "Files" -.IX Subsection "Files" -.IP "\-load \fI\s-1FILENAME\s0\fR" 4 +.IP "Files" 5 +.IX Item "Files" +.PD 0 +.IP "\-load \s-1FILENAME\s0" 5 .IX Item "-load FILENAME" +.PD load or attach \s-1FILENAME\s0 -.IP "\-run \fI\s-1FILENAME\s0\fR" 4 +.IP "\-run \s-1FILENAME\s0" 5 .IX Item "-run FILENAME" load or attach \s-1FILENAME\s0 and attempt autorun -.SS "Cassettes" -.IX Subsection "Cassettes" -.IP "\-tape\-write \fI\s-1FILENAME\s0\fR" 4 +.IP "Cassettes" 5 +.IX Item "Cassettes" +.PD 0 +.IP "\-tape\-write \s-1FILENAME\s0" 5 .IX Item "-tape-write FILENAME" +.PD open \s-1FILENAME\s0 for tape writing -.IP "\-no\-tape\-fast" 4 +.IP "\-no\-tape\-fast" 5 .IX Item "-no-tape-fast" disable fast tape loading -.IP "\-tape\-pad" 4 +.IP "\-tape\-pad" 5 .IX Item "-tape-pad" force tape leader padding -.IP "\-no\-tape\-pad\-auto" 4 +.IP "\-no\-tape\-pad\-auto" 5 .IX Item "-no-tape-pad-auto" disable automatic leader padding -.IP "\-tape\-rewrite" 4 +.IP "\-tape\-rewrite" 5 .IX Item "-tape-rewrite" enable tape rewriting -.SS "Disks" -.IX Subsection "Disks" -.IP "\-disk\-write\-back" 4 +.IP "Disks" 5 +.IX Item "Disks" +.PD 0 +.IP "\-disk\-write\-back" 5 .IX Item "-disk-write-back" +.PD default to enabling write-back for disk images -.IP "\-disk\-jvc\-hack" 4 -.IX Item "-disk-jvc-hack" -autodetect headerless double-sided \s-1JVC\s0 images -.SS "Firmware \s-1ROM\s0 images" -.IX Subsection "Firmware ROM images" -.IP "\-rompath \fI\s-1PATH\s0\fR" 4 +.IP "\-no\-disk\-auto\-os9" 5 +.IX Item "-no-disk-auto-os9" +don't try to detect headerless \s-1OS\-9 JVC\s0 disk images +.IP "Firmware \s-1ROM\s0 images" 5 +.IX Item "Firmware ROM images" +.PD 0 +.IP "\-rompath \s-1PATH\s0" 5 .IX Item "-rompath PATH" +.PD \&\s-1ROM\s0 search path (colon-separated list) -.IP "\-romlist \fINAME=LIST\fR" 4 +.IP "\-romlist NAME=LIST" 5 .IX Item "-romlist NAME=LIST" define a \s-1ROM\s0 list -.IP "\-romlist\-print" 4 +.IP "\-romlist\-print" 5 .IX Item "-romlist-print" print defined \s-1ROM\s0 lists -.IP "\-crclist \fINAME=LIST\fR" 4 +.IP "\-crclist NAME=LIST" 5 .IX Item "-crclist NAME=LIST" define a \s-1ROM CRC\s0 list -.IP "\-crclist\-print" 4 +.IP "\-crclist\-print" 5 .IX Item "-crclist-print" print defined \s-1ROM CRC\s0 lists -.IP "\-force\-crc\-match" 4 +.IP "\-force\-crc\-match" 5 .IX Item "-force-crc-match" force per-architecture \s-1CRC\s0 matches -.SS "User interface" -.IX Subsection "User interface" -.IP "\-ui \fI\s-1MODULE\s0\fR" 4 +.IP "User interface" 5 +.IX Item "User interface" +.PD 0 +.IP "\-ui \s-1MODULE\s0" 5 .IX Item "-ui MODULE" -user-interface module (\-ui help for list) -.SS "Video" -.IX Subsection "Video" -.IP "\-vo \fI\s-1MODULE\s0\fR" 4 +.PD +user-interface module (\fB\-ui help\fR for list) +.IP "Video" 5 +.IX Item "Video" +.PD 0 +.IP "\-vo \s-1MODULE\s0" 5 .IX Item "-vo MODULE" -video module (\-vo help for list) -.IP "\-fs" 4 +.PD +video module (\fB\-vo help\fR for list) +.IP "\-fs" 5 .IX Item "-fs" start emulator full-screen if possible -.IP "\-fskip \fI\s-1FRAMES\s0\fR" 4 +.IP "\-fskip \s-1FRAMES\s0" 5 .IX Item "-fskip FRAMES" frameskip (default: 0) -.IP "\-ccr \fI\s-1RENDERER\s0\fR" 4 +.IP "\-ccr \s-1RENDERER\s0" 5 .IX Item "-ccr RENDERER" -cross-colour renderer (\-ccr help for list) -.IP "\-geometry \fIWxH+X+Y\fR" 4 +cross-colour renderer (\fB\-ccr help\fR for list) +.IP "\-geometry WxH+X+Y" 5 .IX Item "-geometry WxH+X+Y" initial emulator geometry -.IP "\-invert\-text" 4 +.IP "\-invert\-text" 5 .IX Item "-invert-text" start with text mode inverted -.SS "Audio" -.IX Subsection "Audio" -.IP "\-ao \fI\s-1MODULE\s0\fR" 4 +.IP "Audio" 5 +.IX Item "Audio" +.PD 0 +.IP "\-ao \s-1MODULE\s0" 5 .IX Item "-ao MODULE" -audio module (\-ao help for list) -.IP "\-ao\-device \fI\s-1STRING\s0\fR" 4 +.PD +audio module (\fB\-ao help\fR for list) +.IP "\-ao\-device \s-1STRING\s0" 5 .IX Item "-ao-device STRING" device to use for audio module -.IP "\-ao\-rate \fI\s-1HZ\s0\fR" 4 +.IP "\-ao\-format \s-1FMT\s0" 5 +.IX Item "-ao-format FMT" +set audio sample format (\fB\-ao\-format help\fR for list) +.IP "\-ao\-rate \s-1HZ\s0" 5 .IX Item "-ao-rate HZ" set audio frame rate (if supported by module) -.IP "\-ao\-channels \fIN\fR" 4 +.IP "\-ao\-channels N" 5 .IX Item "-ao-channels N" set number of audio channels, 1 or 2 -.IP "\-ao\-fragments \fIN\fR" 4 +.IP "\-ao\-fragments N" 5 .IX Item "-ao-fragments N" set number of audio fragments -.IP "\-ao\-fragment\-ms \fI\s-1MS\s0\fR" 4 +.IP "\-ao\-fragment\-ms \s-1MS\s0" 5 .IX Item "-ao-fragment-ms MS" set audio fragment size in ms (if supported) -.Sp -\&\-ao\-fragment\-frames N set audio fragment size in samples (if supported) -=item \-ao\-buffer\-ms \fI\s-1MS\s0\fR -.Sp +.IP "\-ao\-fragment\-frames N" 5 +.IX Item "-ao-fragment-frames N" +set audio fragment size in samples (if supported) +.IP "\-ao\-buffer\-ms \s-1MS\s0" 5 +.IX Item "-ao-buffer-ms MS" set total audio buffer size in ms (if supported) -.IP "\-ao\-buffer\-frames \fIN\fR" 4 +.IP "\-ao\-buffer\-frames N" 5 .IX Item "-ao-buffer-frames N" set total audio buffer size in samples (if supported) -.IP "\-volume \fI\s-1VOLUME\s0\fR" 4 +.IP "\-volume \s-1VOLUME\s0" 5 .IX Item "-volume VOLUME" audio volume (0 \- 100) -.IP "\-fast\-sound" 4 +.IP "\-fast\-sound" 5 .IX Item "-fast-sound" faster but less accurate sound -.SS "Keyboard" -.IX Subsection "Keyboard" -.IP "\-keymap \fI\s-1CODE\s0\fR" 4 +.IP "Keyboard" 5 +.IX Item "Keyboard" +.PD 0 +.IP "\-keymap \s-1CODE\s0" 5 .IX Item "-keymap CODE" -host keyboard type (\-keymap help for list) -.IP "\-kbd\-translate" 4 +.PD +host keyboard type (\fB\-keymap help\fR for list) +.IP "\-kbd\-translate" 5 .IX Item "-kbd-translate" enable keyboard translation -.IP "\-type \fI\s-1STRING\s0\fR" 4 +.IP "\-type \s-1STRING\s0" 5 .IX Item "-type STRING" intercept \s-1ROM\s0 calls to type \s-1STRING\s0 into \s-1BASIC\s0 -.SS "Joysticks" -.IX Subsection "Joysticks" -See \fB\s-1JOYSTICK SPECS\s0\fR below for the description of the \fB\s-1SPEC\s0\fR -arguments. -.IP "\-joy \fI\s-1NAME\s0\fR" 4 +.IP "Joysticks" 5 +.IX Item "Joysticks" +See \s-1JOYSTICK SPECS\s0 below for the description of the \s-1SPEC\s0 arguments. +.IP "\-joy \s-1NAME\s0" 5 .IX Item "-joy NAME" -configure named joystick (\-joy help for list) -.IP "\-joy\-desc \fI\s-1TEXT\s0\fR" 4 +configure named joystick (\fB\-joy help\fR for list) +.IP "\-joy\-desc \s-1TEXT\s0" 5 .IX Item "-joy-desc TEXT" joystick description -.IP "\-joy\-axis \fIAXIS=SPEC\fR" 4 +.IP "\-joy\-axis AXIS=SPEC" 5 .IX Item "-joy-axis AXIS=SPEC" configure joystick axis -.IP "\-joy\-button \fIBTN=SPEC\fR" 4 +.IP "\-joy\-button BTN=SPEC" 5 .IX Item "-joy-button BTN=SPEC" configure joystick button -.IP "\-joy\-right \fI\s-1NAME\s0\fR" 4 +.IP "\-joy\-right \s-1NAME\s0" 5 .IX Item "-joy-right NAME" map right joystick -.IP "\-joy\-left \fI\s-1NAME\s0\fR" 4 +.IP "\-joy\-left \s-1NAME\s0" 5 .IX Item "-joy-left NAME" map left joystick -.IP "\-joy\-virtual \fI\s-1NAME\s0\fR" 4 +.IP "\-joy\-virtual \s-1NAME\s0" 5 .IX Item "-joy-virtual NAME" -specify the 'virtual' joystick to cycle [kjoy0] -.SS "Printing" -.IX Subsection "Printing" -.IP "\-lp\-file \fI\s-1FILENAME\s0\fR" 4 +specify the `virtual' joystick to cycle [kjoy0] +.IP "Printing" 5 +.IX Item "Printing" +.PD 0 +.IP "\-lp\-file \s-1FILENAME\s0" 5 .IX Item "-lp-file FILENAME" +.PD append Dragon printer output to \s-1FILENAME\s0 -.IP "\-lp\-pipe \fI\s-1COMMAND\s0\fR" 4 +.IP "\-lp\-pipe \s-1COMMAND\s0" 5 .IX Item "-lp-pipe COMMAND" pipe Dragon printer output to \s-1COMMAND\s0 -.SS "Debugging" -.IX Subsection "Debugging" -.IP "\-gdb" 4 +.IP "Debugging" 5 +.IX Item "Debugging" +.PD 0 +.IP "\-gdb" 5 .IX Item "-gdb" +.PD disable \s-1GDB\s0 target -.IP "\-gdb\-ip" 4 +.IP "\-gdb\-ip" 5 .IX Item "-gdb-ip" address of interface for \s-1GDB\s0 target [localhost] -.IP "\-gdb\-port" 4 +.IP "\-gdb\-port" 5 .IX Item "-gdb-port" port for \s-1GDB\s0 target to listen on [65520] -.IP "\-trace" 4 +.IP "\-trace" 5 .IX Item "-trace" start with trace mode on -.IP "\-debug\-ui \fI\s-1FLAGS\s0\fR" 4 +.IP "\-debug\-ui \s-1FLAGS\s0" 5 .IX Item "-debug-ui FLAGS" \&\s-1UI\s0 debugging (see manual, or \-1 for all) -.IP "\-debug\-file \fI\s-1FLAGS\s0\fR" 4 +.IP "\-debug\-file \s-1FLAGS\s0" 5 .IX Item "-debug-file FLAGS" file debugging (see manual, or \-1 for all) -.IP "\-debug\-fdc \fI\s-1FLAGS\s0\fR" 4 +.IP "\-debug\-fdc \s-1FLAGS\s0" 5 .IX Item "-debug-fdc FLAGS" \&\s-1FDC\s0 debugging (see manual, or \-1 for all) -.IP "\-debug\-gdb \fI\s-1FLAGS\s0\fR" 4 +.IP "\-debug\-gdb \s-1FLAGS\s0" 5 .IX Item "-debug-gdb FLAGS" \&\s-1GDB\s0 target debugging (see manual, or \-1 for all) -.IP "\-timeout \fI\s-1SECONDS\s0\fR" 4 +.IP "\-v, verbose \s-1LEVEL\s0" 5 +.IX Item "-v, verbose LEVEL" +general debug verbosity (0\-3) [1] +.IP "\-q, \-\-quiet" 5 +.IX Item "-q, --quiet" +equivalent to \-\-verbose 0 +.IP "\-timeout \s-1SECONDS\s0" 5 .IX Item "-timeout SECONDS" run for \s-1SECONDS\s0 then quit -.SS "Other options" -.IX Subsection "Other options" -.IP "\-config\-print" 4 +.SH "Other options" +.IX Header "Other options" +.IP "\-config\-print" 5 .IX Item "-config-print" print full configuration to standard output -.IP "\-h, \-\-help" 4 +.IP "\-h, \-\-help" 5 .IX Item "-h, --help" display this help and exit -.IP "\-\-version" 4 -.IX Item "--version" +.IP "\-V, \-\-version" 5 +.IX Item "-V, --version" output version information and exit .SH "JOYSTICK SPECS" .IX Header "JOYSTICK SPECS" Joystick SPECs are of the form [\s-1INTERFACE:\s0][ARG[,ARG]...], from: .PP -.Vb 4 +.Vb 1 \& 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 .Ve .PP -For physical joysticks a '\-' before the axis index inverts the axis. -\&\s-1AXIS 0\s0 is the X\-axis, and \s-1AXIS 1\s0 the Y\-axis. \s-1BTN 0\s0 is the only one used -so far, but in the future \s-1BTN 1\s0 will be the second button on certain -CoCo joysticks. +For physical joysticks a `\-' before the axis index inverts the axis. \s-1AXIS 0\s0 is the X\-axis, and \s-1AXIS 1\s0 the +Y\-axis. \s-1BTN 0\s0 is the only one used so far, but in the future \s-1BTN 1\s0 will be the second button on certain CoCo +joysticks. .SH "COPYRIGHT" .IX Header "COPYRIGHT" xroar is Copyright (c) 2009 Ciaran Anscomb .PP -This man page written by B. Watson for the SlackBuilds.org project (but it -may be used by anyone). +This man page written by B. Watson for the SlackBuilds.org project (but it may be used by anyone). .PP -This is free software. You may redistribute copies of it under the terms of -the \s-1GNU\s0 General Public License <http://www.gnu.org/licenses/gpl.html>. -There is \s-1NO WARRANTY,\s0 to the extent permitted by law. +This is free software. You may redistribute copies of it under the terms of the \s-1GNU\s0 General Public License +<http://www.gnu.org/licenses/gpl.html>. There is \s-1NO WARRANTY,\s0 to the extent permitted by law. .SH "SEE ALSO" .IX Header "SEE ALSO" -The info page for \fBxroar\fR (includes much information not found in this man page). +The info page for xroar (includes much information not found in this man page). .PP http://en.wikipedia.org/wiki/TRS\-80_Color_Computer .PP diff --git a/games/xroar/xroar.SlackBuild b/games/xroar/xroar.SlackBuild index d3a37f586ccd9..49d407a9201e2 100644 --- a/games/xroar/xroar.SlackBuild +++ b/games/xroar/xroar.SlackBuild @@ -6,6 +6,10 @@ # Licensed under the WTFPL. See http://www.wtfpl.net/txt/copying/ for details. +# 20140824 bkw: +# - update for 0.32 +# - somehow I lost the POD source to the man page, recreate from xroar.6 + # 20140313 bkw: # - update for 0.31.1 # - change download link to upstream's, looks OK now @@ -26,7 +30,7 @@ # - mention gtkglext in README as an optional dep PRGNAM=xroar -VERSION=${VERSION:-0.31.1} +VERSION=${VERSION:-0.32} BUILD=${BUILD:-1} TAG=${TAG:-_SBo} @@ -150,6 +154,15 @@ cp -a COPYING* ChangeLog $PKG/usr/doc/$PRGNAM-$VERSION make doc/$PRGNAM.html cp doc/$PRGNAM.html doc/*png $PKG/usr/doc/$PRGNAM-$VERSION +# Don't keep duplicates of the doc images, use symlinks +cd $PKG/usr/info +for i in *.png; do + if [ -e ../doc/$PRGNAM-$VERSION/$i ]; then + rm -f $i + ln -s ../doc/$PRGNAM-$VERSION/$i . + fi +done + cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild mkdir -p $PKG/install diff --git a/games/xroar/xroar.info b/games/xroar/xroar.info index 5fc7b6ce09f97..3fbd389a38548 100644 --- a/games/xroar/xroar.info +++ b/games/xroar/xroar.info @@ -1,8 +1,8 @@ PRGNAM="xroar" -VERSION="0.31.1" +VERSION="0.32" HOMEPAGE="http://www.6809.org.uk/dragon/xroar.shtml" -DOWNLOAD="http://www.6809.org.uk/xroar/download/0.31/xroar-0.31.1.tar.gz" -MD5SUM="d5e1a730be225547e216c218789e1019" +DOWNLOAD="http://www.6809.org.uk/xroar/download/0.32/xroar-0.32.tar.gz" +MD5SUM="744c99c9fe08479963394391b54f6c78" DOWNLOAD_x86_64="" MD5SUM_x86_64="" REQUIRES="" diff --git a/games/xroar/xroar.pod b/games/xroar/xroar.pod new file mode 100644 index 0000000000000..a01e29cd8b7c1 --- /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 |