--- doc/xmame.man.old	Thu Jul  9 06:54:08 1998
+++ doc/xmame.man	Thu Jul  9 06:54:55 1998
@@ -1,4 +1,4 @@
-.\" Copyright (c) 1997 Donald Burr <dburr@POBoxes.com>
+.\" Copyright (c) 1998 Donald Burr <dburr@FreeBSD.ORG>
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -26,7 +26,7 @@
 .\"
 .\" Note: The date here should be updated whenever a non-trivial
 .\" change is made to the manual page.
-.Dd November 25 1997
+.Dd January 30 1998
 .Dt XMAME 6
 .\" Note: Only specify the operating system when the command
 .\" is FreeBSD specific, otherwise use the .Os macro with no
@@ -54,8 +54,6 @@
 with ``no'', which acts to disable the option in question.
 Here are the most common ones:
 .Bl -tag -width Fl
-.It Fl help
-Displays a help screen, summarizing the command line options.
 .It Fl joy
 Allows you to use the joystick driver to control the game.  (Specific to
 Linux.)
@@ -115,6 +113,11 @@
 .Ar nframes
 frames between video refreshes.  Useful for making slowish games run
 faster on slow video hardware or CPU's.
+.It Fl display Ar display
+Displays the
+.Nm
+window on X display
+.Ar display
 .It Fl mitshm
 Activates MIT shared memory X server extension support.  The default
 XFree86 servers support this, so you should probably use it.  If enabled,
@@ -180,6 +183,8 @@
 .It Fl showconfig
 Displays the running parameters in a style suitable for insertion into an
 xmamerc file.
+.It Fl help
+Displays a help screen, summarizing the command line options.
 .It Fl list
 Lists all of the games supported by this version of
 .Nm
@@ -272,16 +277,19 @@
 (see the LEGAL NOTICE section for more details.)
 
 The game ROM images come in ZIP files.  Download the ZIP files for the games
-you want, and move them to the /usr/local/games/lib/mame directory.  For
-each game, unzip it into its own directory (i.e. if you want to install
-PacMan, get ``pacman.zip,'' make a directory called ``pacman'' (under the
-/usr/local/games/lib/mame hierarchy), and unzip the pacman.zip file INSIDE
-that directory.
-
-Some games require the game ROM files to be in an unusually-named directory.
-For example, Dig Dug uses the directory name ``digdugnm.''  Read the file
-/usr/local/games/lib/mame/readme.txt to find out the names of the directories
-for particular games.
+you want, and move them to the /usr/local/lib/mame/roms directory.
+
+Some games require audio samples to enable sound.  These can usually be
+downloaded at the same place where you obtain ROMs.  These can be installed,
+in zipped form, in the directory /usr/local/lib/mame/samples.
+
+(In previous versions of
+.Nm
+you had to un-zip each game and the samples that it uses
+into its own directory.  This is no longer
+necessary, as
+.Nm
+now automatically un-zips games and samples ``on the fly'' as needed.)
 .Sh PLAYING GAMES
 Okay, so you've got your games installed.  Now what?
 
@@ -337,7 +345,7 @@
 has MANY controls for shields, warp speed, whatnot; while the Mario Bros.
 game uses a second set of keys to control the Luigi player (2nd player).
 If you want to find out what keys a particular game uses, look at the
-/usr/local/games/lib/mame/readme.txt file.
+/usr/local/lib/mame/readme.dos file.
 
 HAVE FUN!!!
 .Sh ENVIRONMENT
@@ -352,23 +360,32 @@
 X server to display in.
 .El
 .Sh FILES
-.Bl -tag -width /usr/local/games/lib/mame/readme.txt -compact
-.It Pa /usr/local/games/lib/mame
-Directory containing arcade game ROM files
-(the ROMs for each game live in a subdirectory with the same name as
-the game, e.g. ``/usr/local/games/lib/mame/pacman''.
-.It Pa /usr/local/games/lib/mame/readme.txt
+.Bl -tag -width /usr/local/lib/mame/readme.dos -compact
+.It Pa /usr/local/lib/mame
+Main
+.Nm
+directory.  Contains the default configuration file (xmamerc); the
+directories for game configurations, high scores, ROMs, and samples;
+various README and documentation files; and the cheat data file,
+among others.
+.It Pa /usr/local/lib/mame/cfg
+Directory containing the configuration data for each game.
+.It Pa /usr/local/lib/mame/hi
+Directory containing high score tables for each game.
+.It Pa /usr/local/lib/mame/roms
+Directory containing (zipped) ROM files.
+.It Pa /usr/local/lib/mame/samples
+Directory containing (zipped) audio sample files.
+.It Pa /usr/local/lib/mame/readme.dos
 File containing list of supported games, keyboard commands for each
 game, and bugs and other incompatibilities with certain games.
-.It Pa /usr/local/games/lib/mame/xmamerc
+.It Pa /usr/local/lib/mame/xmamerc
 System-wide configuration file for
 .Nm
 .It Pa ${HOME}/xmame/xmamerc
 Per-user configuration file for
 .Nm
 (overrides system configuration if exists).
-.It Pa ${HOME}/xmame/<game>.cnf
-Per-user configuration file of a particular game.
 .El
 .Sh EXAMPLES
 The following is an example of a typical usage
@@ -376,23 +393,15 @@
 .Nm
 command:
 .Pp
-.Dl %
-.Nm
-pacman
+.Dl % xmame pacman
 plays Pacman with all default options
-.Dl %
-.Nm
-dkong -frameskip 1
+.Dl % xmame dkong -frameskip 1
 plays Donkey Kong using frameskip of 1.  Useful for slower computers,
 if the game is running really slowly.
-.Dl %
-.Nm
-superpac -scale 2
+.Dl % xmame superpac -scale 2
 plays Super PacMan with a double-sized screen (note that this slows the
 game down).
-.Dl %
-.Nm
-superpac -heightscale 2 -widthscale 2
+.Dl % xmame superpac -heightscale 2 -widthscale 2
 Same as above, but using separate -heightscale and -widthscale arguments.
 .Sh SEE ALSO
 .Xr X 1
@@ -443,4 +452,4 @@
 .Sh BUGS
 Some game hardware isn't completely emulated, especially sound.
 Probably other bugs, too.
-See the readme.txt file for more bugs.
+See the readme.dos file for more bugs.
