diff --git a/src/osd/sdl/man/mame.6 b/src/osd/sdl/man/mame.6 index 76608ffbe67..e7548de3efd 100644 --- a/src/osd/sdl/man/mame.6 +++ b/src/osd/sdl/man/mame.6 @@ -13,7 +13,7 @@ .\" and updated by Andrew Burton , July 2003 .\" .\" -.TH MAME 6 2013-01-28 0.148u1 "MAME \- The Multiple Arcade Machine Emulator" +.TH MAME 6 2013-06-12 0.149 "MAME \- The Multiple Arcade Machine Emulator" .\" .\" .\" NAME chapter @@ -155,17 +155,24 @@ Output the list of available media for the system. .B \-listsoftware, \-lsoft Output the list of known software for the system. .TP -.B \-verifysoftware, \-vsoft -Verify known software for the system. +.B \-verifysoftware, \-vsoft \fR[\fIgamename\fR|\fIwildcard\fR] +Checks for invalid or missing ROM images in your software lists. +By default all drivers that have valid ZIP files or directories +in the rompath are verified; however, you can limit this list by +specifying a specific driver name or wildcard. .TP .B \-getsoftlist, \-glist Retrieve software list by name. .TP -.B \-verifysoftlist, \-vlist -Verify software list by name. +.B \-verifysoftlist, \-vlist \fR[\fIsoftwarelistname\fR] +Checks a specified software list for missing ROM images if files exist +for issued softwarelistname. By default, all drivers that have valid +ZIP files or directories in the rompath are verified; however, you can +limit this list by specifying a specific softwarelistname (without .XML). .TP .B \-listmidi, \-mlist -List available MIDI I/O devices. +Create a list of list available MIDI I/O devices for use with emulation. + .\" .\" ******************************************************* .SS Configuration options @@ -179,7 +186,7 @@ Enables or disables the reading of the config files. When enabled .br the main configuration file .br -2. \fI[name]\fB.ini\fR +2. \fIname\fB.ini\fR .br where \fIname\fR is your executable name, i.e. mame unless you changed it (e.g. if you renamed mame to mame0137, the parsed file will be @@ -361,18 +368,21 @@ consistent, you should only record and playback with all configuration (.cfg), NVRAM (.nv), and memory card files deleted. The default is NULL (no recording). .TP -.B \-snapname \fIname -Describes how MAME should name files for snapshots. \fIname\fP is a string -that provides a template that is used to generate a filename. Three +.B \-snapname \fIstring +Describes how MAME should name files for snapshots. \fIstring\fP +provides a template that is used to generate a filename. Three simple substitutions are provided: the / character represents the -path separator on any target platform (even Windows); the string \fI%g\fP -represents the driver name of the current game; and the string \fI%i\fP -represents an incrementing index. If \fI%i\fP is omitted, then each +path separator on any target platform (even Windows); the literal \fB%g\fP +represents the driver name of the current game; and the literal \fB%i\fP +represents an incrementing index. If \fB%i\fP is omitted, then each snapshot taken will overwrite the previous one; otherwise, MAME will -find the next empty value for \fI%i\fP and use that for a filename. The -default is \fI%g/%i\fP, which creates a separate folder for each game, +find the next empty value for \fB%i\fP and use that for a filename. The +default is \fB%g/%i\fP, which creates a separate folder for each game, and names the snapshots under it starting with 0000 and increasing -from there. +from there. Example: if you use +.B mame robby \-snapname foo/%g%i +snapshots will be saved as \fBsnaps/foo/robby0000.png\fP, +\fBsnaps/foo/robby0001.png\fP and so on. .TP .B \-snapsize \fIwidth\fPx\fIheight Hard\-codes the size for snapshots and movie recording. By default, @@ -396,6 +406,17 @@ specified by \fIviewname\fP. For example, \-snapview native will match the \fIviewname\fP can also be 'auto', which selects the first view with all screens present. The default value is 'internal'. .TP +.B \-statename \fIstring +Describes how MAME should store save state files, relative to the +state_directory path. \fIstring\fP provides a template that +is used to generate a relative path. Two simple substitutions are +provided: the / character represents the path separator on any target +platform (even Windows); the literal \fB%g\fP represents the driver name of +the current game. The default is '%g', which creates a separate folder +for each game. Example: if you use +.B mame robby \-statename foo/%g +save states will be stored inside \fBsta/foo/robby/\fP. +.TP .B \-mngwrite \fIfilename Writes each video frame to the given \fIfilename\fP in MNG format, producing an animation of the game session. Note that \-mngwrite only writes video @@ -913,7 +934,10 @@ the maximum range. This option expects a float in the range of 0.0 to The default is 0.85. .TP .B \-natural, \-nat -Specifies whether to use a natural keyboard or not. +Allows user to specify whether or not to use a natural keyboard. +This allows you to start your game or system in a 'native' mode, depending +on your region, allowing compatability for non\-"QWERTY" style keyboards. +The default is OFF (-nonatural). .TP .B \-joystick_contradictory Enable contradictory direction digital joystick input at the same time. @@ -1055,6 +1079,20 @@ Display confirm quit screen on exit. .TP .B \-ui_mouse Display UI mouse cursor. +.TP +.B \-autoboot_command, \-ab \fIcommand +Command string to execute after machine boot (in quotes ""). To issue +a quote to the emulation, use \fB"""\fP in the string. +Using \fB\\n\fP will issue a create a new line, issuing what was +typed prior as a command. Example: +\fB\-autoboot_command "load """$""",8,1\\n"\fP. +.TP +.B \-autoboot_delay \fR[\fIseconds\fP] +Timer delay (in seconds) to trigger command execution on autoboot. +Default is 2. +.TP +.B \-autoboot_script, \-script \fR[\fIfilename.lua\fP] +File containing scripting to execute after machine boot. .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ .\" SDL specific .\" +++++++++++++++++++++++++++++++++++++++++++++++++++++++ diff --git a/src/osd/sdl/man/mess.6 b/src/osd/sdl/man/mess.6 index ecca8f17c8c..624a3f052c4 100644 --- a/src/osd/sdl/man/mess.6 +++ b/src/osd/sdl/man/mess.6 @@ -16,7 +16,7 @@ .\" http://www.mess.org/ .\" .\" -.TH MESS 6 2013-01-28 0.148u1 "The Multiple Emulator Super System (MESS)" +.TH MESS 6 2013-06-12 0.149 "The Multiple Emulator Super System (MESS)" .\" .\" .\" NAME chapter @@ -154,14 +154,20 @@ Output the list of available media for the system. .B \-listsoftware, \-lsoft Output the list of known software for the system. .TP -.B \-verifysoftware, \-vsoft -Verify known software for the system. +.B \-verifysoftware, \-vsoft \fR[\fIgamename\fR|\fIwildcard\fR] +Checks for invalid or missing ROM images in your software lists. +By default all drivers that have valid ZIP files or directories +in the rompath are verified; however, you can limit this list by +specifying a specific driver name or wildcard. .TP .B \-getsoftlist, \-glist Retrieve software list by name. .TP -.B \-verifysoftlist, \-vlist -Verify software list by name. +.B \-verifysoftlist, \-vlist \fR[\fIsoftwarelistname\fR] +Checks a specified software list for missing ROM images if files exist +for issued softwarelistname. By default, all drivers that have valid +ZIP files or directories in the rompath are verified; however, you can +limit this list by specifying a specific softwarelistname (without .XML). .TP .B \-listmidi, \-mlist List available MIDI I/O devices. @@ -353,18 +359,25 @@ consistent, you should only record and playback with all configuration (.cfg), NVRAM (.nv), and memory card files deleted. The default is NULL (no recording). .TP -.B \-snapname \fIname -Describes how MESS should name files for snapshots. \fIname\fP is a string -that provides a template that is used to generate a filename. Three +.B \-snapname \fIstring +Describes how MESS should name files for snapshots. \fIstring\fP +provides a template that is used to generate a filename. Three simple substitutions are provided: the / character represents the -path separator on any target platform (even Windows); the string \fI%g\fP -represents the driver name of the current system; and the string \fI%i\fP -represents an incrementing index. If \fI%i\fP is omitted, then each +path separator on any target platform (even Windows); the literal \fB%g\fP +represents the driver name of the current system; and the literal \fB%i\fP +represents an incrementing index. If \fB%i\fP is omitted, then each snapshot taken will overwrite the previous one; otherwise, MESS will -find the next empty value for \fI%i\fP and use that for a filename. The -default is \fI%g/%i\fP, which creates a separate folder for each game, +find the next empty value for \fB%i\fP and use that for a filename. The +default is '%g/%i', which creates a separate folder for each game, and names the snapshots under it starting with 0000 and increasing -from there. +from there. In addition to the above, for drivers using different +media, like carts or floppy disks, you can also use the +\fB%d\fP\fI_[media]\fP indicator. Replace \fI[media]\fP with the media +switch you want to use. A few examples: if you use +.B mess nes \-cart robby \-snapname %g/%d_cart +snapshots will be saved as \fBsnaps/nes/robby.png\fP; if you use +.B mess c64 \-flop1 robby \-snapname %g/%d_flop1/%i +snapshots will be saved as \fBsnaps/c64/robby/0000.png\fP. .TP .B \-snapsize \fIwidth\fRx\fIheight Hard\-codes the size for snapshots and movie recording. By default, @@ -388,6 +401,22 @@ specified by \fIviewname\fP. For example, \-snapview native will match the \fIviewname\fP can also be 'auto', which selects the first view with all screens present. The default value is 'internal'. .TP +.B \-statename \fIstring +Describes how MESS should store save state files, relative to the +state_directory path. \fIstring\fP provides a template that +is used to generate a relative path. Two simple substitutions are +provided: the / character represents the path separator on any target +platform (even Windows); the literal \fB%g\fP represents the driver name of +the current game. The default is '%g', which creates a separate folder +for each game. In addition to the above, for drivers using different +media, like carts or floppy disks, you can also use the +\fB%d_\fP\fI[media]\fP indicator. Replace \fI[media]\fP with the media +switch you want to use. A few examples: if you use +.B mess nes \-cart robby \-statename %g/%d_cart +save states will be stored inside \fBsta/nes/robby/\fP; if you use +.B mess c64 \-flop1 robby \-statename %g/%d_flop1 +save states will be stored inside \fBsta/c64/robby/\fP. +.TP .B \-mngwrite \fIfilename Writes each video frame to the given file in MNG format, producing an animation of the system session. @@ -893,7 +922,10 @@ the maximum range. This option expects a float in the range of 0.0 to The default is 0.85. .TP .B \-natural, \-nat -Specifies whether to use a natural keyboard or not. +Allows user to specify whether or not to use a natural keyboard. +This allows you to start your game or system in a 'native' mode, depending +on your region, allowing compatability for non\-"QWERTY" style keyboards. +The default is OFF (-nonatural). .TP .B \-uimodekey, \-umk Specifies the key used to toggle between full and partial UI mode. @@ -1030,6 +1062,20 @@ Display confirm quit screen on exit. .B \-ui_mouse Display UI mouse cursor. .TP +.B \-autoboot_command, \-ab \fIcommand +Command string to execute after machine boot (in quotes ""). To issue +a quote to the emulation, use \fB"""\fP in the string. +Using \fB\\n\fP will issue a create a new line, issuing what was +typed prior as a command. Example: +\fB\-autoboot_command "load """$""",8,1\\n"\fP. +.TP +.B \-autoboot_delay \fR[\fIseconds\fP] +Timer delay (in seconds) to trigger command execution on autoboot. +Default is 2. +.TP +.B \-autoboot_script, \-script \fR[\fIfilename.lua\fP] +File containing scripting to execute after machine boot. +.TP .B \-newui, \-nu Use the new MESS UI. .TP