From 37157461313b13a691722b83c87df8d2315457da Mon Sep 17 00:00:00 2001 From: Vas Crabb Date: Thu, 15 Jul 2021 04:09:18 +1000 Subject: API cleanups and miscellaneous fixes. emu/ioport.cpp: Allow controller files to override input sequences for inputs that don't use defaults, and to override the toggle setting for digital inputs. emu/config.cpp: Expose configuration level (mostly matters for controller files), improved verbose diagnostic messages, and moved a few things out of the global and preprocessor namespaces. docs: Added documentation for some controller configuration file features. The device mapping feature documentation will be merged in at some point. util/unicode.cpp, emu/input.cpp: API cleanups. --- docs/source/commandline/commandline-all.rst | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) (limited to 'docs/source/commandline') diff --git a/docs/source/commandline/commandline-all.rst b/docs/source/commandline/commandline-all.rst index 7979d98b3a8..de46760271a 100644 --- a/docs/source/commandline/commandline-all.rst +++ b/docs/source/commandline/commandline-all.rst @@ -32,7 +32,6 @@ patterns to avoid having your shell try to expand them against filenames (e.g. .. _mame-commandline-paths: - File Names and Directory Paths ------------------------------ @@ -1087,7 +1086,7 @@ Core Search Path Options .. _mame-commandline-artpath: -**-artpath** ** ** +**-artpath** ** Specifies one or more paths within which to find external layout and artwork files. Multiple paths can be specified by separating them with semicolons. @@ -1104,8 +1103,9 @@ Core Search Path Options **-ctrlrpath** ** - Specifies one or more paths within which to find default input configuration + Specifies one or more paths within which to find controller configuration files. Multiple paths can be specified by separating them with semicolons. + Used in conjunction with the ``-ctrlr`` option. The default is ``ctrlr`` (that is, a directory ``ctrlr`` in the current working directory). @@ -2942,11 +2942,13 @@ Core Input Options **-ctrlr** ** - Enables support for special controllers. Configuration files are loaded from - the ctrlrpath. They are in the same format as the .cfg files that are - saved, but only control configuration data is read from the file. + Specifies a controller configuration file, typically used to set more + suitable default input assignments for special controllers. Directories + specified using the ``ctrlrpath`` option are searched. Controller + configuration files use a similar format to ``.cfg`` used to save system + settings. See :ref:`ctrlrcfg` for more details. - The default is ``NULL`` (no controller file). + The default is ``NULL`` (no controller configuration file). Example: .. code-block:: bash -- cgit v1.2.3-70-g09d2