diff options
author | 2019-01-02 10:05:21 -0700 | |
---|---|---|
committer | 2019-01-03 04:05:21 +1100 | |
commit | 6432d6603779cbb8bf5974eca36b88009d7cc429 (patch) | |
tree | 8b83ab71cec65f4c00d228f670b85b4c631603d2 /docs/source/advanced/multiconfig.rst | |
parent | 3d29b8927d5ad4140c69d00713f1e901bae6af97 (diff) |
Case sensitivity training for INI (nw) (#4455)
* Case sensitivity training for INI (nw)
The world is not 100% Windows, so case sensitvity is needed.
* Further standardization of the formatting (nw)
More to go...
* Pass 2 of new formatting wave (nw)
More to go, though.
* wave 3 of formatting cleanup (nw)
Further adjustments and cleanups, including unwanted tabs.
* Correct filtering instructions (nw)
Diffstat (limited to 'docs/source/advanced/multiconfig.rst')
-rw-r--r-- | docs/source/advanced/multiconfig.rst | 38 |
1 files changed, 19 insertions, 19 deletions
diff --git a/docs/source/advanced/multiconfig.rst b/docs/source/advanced/multiconfig.rst index 3424f1fb4ee..48385781392 100644 --- a/docs/source/advanced/multiconfig.rst +++ b/docs/source/advanced/multiconfig.rst @@ -9,43 +9,43 @@ Order of Config Loading ----------------------- 1. The command line is parsed first, and any settings passed that way *will take priority over anything in an INI file*. -2. **MAME.INI** (or other platform INI; e.g. **MESS.INI**) is parsed twice. +2. ``mame.ini`` (or other platform INI; e.g. ``mess.ini``) is parsed twice. The first pass may change various path settings, so the second pass is done to see if there is a valid config file at that new location (and if so, change settings using that file) -3. **DEBUG.INI** if in debug mode. +3. ``debug.ini`` if in debug mode. This is an advanced config file, most people won't need to use it or be concerned by it. -4. System-specific INI files where appropriate (e.g. **NEOGEO_NOSLOT.INI** or **CPS2.INI**) - As an example, Street Fighter Alpha is a CPS2 game, and so **CPS2.INI** would be loaded here. -5. Monitor orientation INI file (either **HORIZONT.INI** or **VERTICAL.INI**) - Pac-Man, for one example, is a vertical monitor setup, so it would load **VERTICAL.INI**. Street Fighter Alpha is a horizontal game, so it loads **HORIZONT.INI**. -6. System-type INI files (**ARCADE.INI**, **CONSOLE.INI**, **COMPUTER.INI**, or **OTHERSYS.INI**) - Both Pac-Man and Street Fighter Alpha are arcade games, so **ARCADE.INI** would be loaded here. Atari 2600 would load **CONSOLE.INI**. -7. Screen-type INI file (**VECTOR.INI** for vector games, **RASTER.INI** for raster games, **LCD.INI** for LCD games) - Pac-Man and Street Fighter Alpha are raster, so **RASTER.INI** gets loaded here. Tempest is a vector monitor game, and **VECTOR.INI** would be loaded here. +4. System-specific INI files where appropriate (e.g. ``neogeo_noslot.ini`` or ``cps2.ini``) + As an example, Street Fighter Alpha is a CPS2 game, and so ``cps2.ini`` would be loaded here. +5. Monitor orientation INI file (either ``horizont.ini`` or ``vertical.ini``) + Pac-Man, for one example, is a vertical monitor setup, so it would load ``vertical.ini``. Street Fighter Alpha is a horizontal game, so it loads ``horizont.ini``. +6. System-type INI files (``arcade.ini``, ``console.ini``, ``computer.ini``, or ``othersys.ini``) + Both Pac-Man and Street Fighter Alpha are arcade games, so ``arcade.ini`` would be loaded here. Atari 2600 would load ``console.ini``. +7. Screen-type INI file (``vector.ini`` for vector games, ``raster.ini`` for raster games, ``lcd.ini`` for LCD games) + Pac-Man and Street Fighter Alpha are raster, so ``raster.ini`` gets loaded here. Tempest is a vector monitor game, and ``vector.ini`` would be loaded here. 8. Source INI files. This is an advanced config file, most people won't need to use it and it can be safely ignored. - MAME will attempt to load **SOURCE/SOURCEFILE.INI** and **SOURCEFILE.INI**, where sourcefile is the actual filename of the source code file. + MAME will attempt to load ``source/sourcefile.ini`` and ``sourcefile.ini``, where sourcefile is the actual filename of the source code file. *mame -listsource <game>* will show the source file for a given game. - For instance, Banpresto's Sailor Moon, Atlus's Dodonpachi, and Nihon System's Dangun Feveron all share a large amount of hardware and are grouped into the CAVE.C file, meaning they all parse **source/cave.ini** + For instance, Banpresto's Sailor Moon, Atlus's Dodonpachi, and Nihon System's Dangun Feveron all share a large amount of hardware and are grouped into the ``cave.c`` file, meaning they all parse ``source/cave.ini`` 9. Parent INI file. - For example, if running Pac-Man, which is a clone of Puck-Man, it'd be **PUCKMAN.INI** + For example, if running Pac-Man, which is a clone of Puck-Man, it'd be ``puckman.ini`` 10. Driver INI file. - Using our previous example of Pac-Man, this would be **PACMAN.INI**. + Using our previous example of Pac-Man, this would be ``pacman.ini``. Examples of Config Loading Order -------------------------------- -1. Alcon, which is the US clone of Slap Fight. (*mame alcon*) - Command line, MAME.INI, VERTICAL.INI, ARCADE.INI, RASTER.INI, SLAPFGHT.INI, and lastly ALCON.INI (*remember command line parameters take precedence over all else!*) +1. Alcon, which is the US clone of Slap Fight. (**mame alcon**) + Command line, mame.ini, vertical.ini, arcade.ini, raster.ini, slapfght.ini, and lastly alcon.ini (*remember command line parameters take precedence over all else!*) -2. Super Street Fighter 2 Turbo (*mame ssf2t*) - Command line, MAME.INI, HORIZONT.INI, ARCADE.INI, RASTER.INI, CPS2.INI, and lastly SSF2T.INI (*remember command line parameters take precedence over all else!*) +2. Super Street Fighter 2 Turbo (**mame ssf2t**) + Command line, mame.ini, horizont.ini, arcade.ini, raster.ini, cps2.ini, and lastly ssf2t.ini (*remember command line parameters take precedence over all else!*) Tricks to Make Life Easier -------------------------- -Some users may have a wall-mounted or otherwise rotatable monitor, and may wish to actually play vertical games with the rotated display. The easiest way to accomplish this is to put your rotation modifiers into **VERTICAL.INI**, where they will only affect vertical games. +Some users may have a wall-mounted or otherwise rotatable monitor, and may wish to actually play vertical games with the rotated display. The easiest way to accomplish this is to put your rotation modifiers into ``vertical.ini``, where they will only affect vertical games. [todo: more practical examples] |