Documentation update

CHANGELOG.md

@@ -60,7 +60,6 @@ In addition to the above many bugs have been fixed and the application has recei
 * Added support for the Taito Type X (type-x) game system
 * Added support for the Microsoft Windows 3.x (windows3x) game system
 * Added support for the Microsoft Windows 9x (windows9x) game system
-* Removed support for the Adventure Game Studio Game Engine (ags) game system
 * Removed support for the Cave Story (NXEngine) (cavestory) game system
 * Removed support for the MAME4ALL (mame-mame4all) game system
 * Removed support for the Moonlight Game Streaming (moonlight) game system
@@ -112,11 +111,13 @@ In addition to the above many bugs have been fixed and the application has recei
 * (Windows) Added %STARTDIR%=%EMUDIR% for the Vita3K and xemu emulators
 * (Windows) Added Demul as an alternative emulator for the atomiswave, dreamcast, naomi and naomi2 systems
 * (Windows) Added 3dSen standalone as an alternative emulator for the famicom and nes systems
+* (Windows) Added Altirra standalone as an alternative emulator for the atari5200, atari800 and atarixe systems
 * (Windows) Added the .url file extension to the epic system
 * (Windows) Added the .lnk file extension to the steam system
 * Removed atarijaguarcd as an extra platform for the atarijaguar system as it actually made scraping worse
 * Added arcade as an extra platform to the daphne system (to improve scraping)
 * Removed the videopac platform ID entry as it's identical to odyssey2
+* Changed the platform for the ags system to pcwindows to improve scraping
 * Changed the platform for the videopac system to odyssey2 to improve scraping
 * Added the snes-msu1 platform so that these games can be scraped using ScreenScraper (requires custom system config)
 * Changed the full name for the vectrex system from "Smith Engineering Vectrex" to "GCE Vectrex"

THEMES-DEV.md

@@ -54,20 +54,41 @@ The directory structure for our example theme could look something like the foll
    mytheme-es-de/
       core/
          font.ttf
-            bold_font.ttf
+         font_bold.ttf
          frame.png
-
       nes/
-            theme.xml
          background.jpg
          logo.svg
-            logo_video.svg
+         theme.xml
-
       snes/
-            theme.xml
          background.jpg
          logo.svg
-            logo_video.svg
+         theme.xml
+
+      fonts.xml
+      theme.xml
+```
+
+An alternative approach would be to instead rely on variables for populating system-specific information and media files, and this way it's not necessary to setup separate directories per system:
+
+```
+...
+themes/
+   mytheme-es-de/
+      core/
+         font.ttf
+         font_bold.ttf
+         frame.png
+      systems/
+         backgrounds/
+            nes.jpg
+            snes.jpg
+         logos/
+            nes.svg
+            snes.svg
+         metadata/
+            nes.xml
+            snes.xml
 
       fonts.xml
       theme.xml

USERGUIDE-DEV.md

@@ -3785,6 +3785,7 @@ The **@** symbol indicates that the emulator is _deprecated_ and will be removed
 | :-------------------- | :--------------------------------------------- | :-------------------------------- | :-------------------------------- | :----------- | :----------------------------------- |
 | 3do                   | 3DO Interactive Multiplayer                    | Opera                             |                                   | Yes          |                                      |
 | adam                  | Coleco Adam                                    | MAME [Diskette] **(Standalone)**  | MAME [Tape] **(Standalone)**,<br>MAME [Cartridge] **(Standalone)**,<br>MAME [Software list] **(Standalone)** | Yes          |                                      |
+| ags                   | Adventure Game Studio Game Engine              | _Shortcut or script_              |                                   | No           |                                      |
 | amiga                 | Commodore Amiga                                | PUAE                              | PUAE 2021,<br>FS-UAE **(Standalone)**,<br>Amiberry **(Standalone)** [UM] | Yes          | See the specific _Commodore Amiga and CDTV_ section elsewhere in this guide |
 | amiga1200             | Commodore Amiga 1200                           | PUAE                              | PUAE 2021,<br>FS-UAE **(Standalone)**,<br>Amiberry **(Standalone)** [UM] | Yes          | See the specific _Commodore Amiga and CDTV_ section elsewhere in this guide |
 | amiga600              | Commodore Amiga 600                            | PUAE                              | PUAE 2021,<br>FS-UAE **(Standalone)**,<br>Amiberry **(Standalone)** [UM] | Yes          | See the specific _Commodore Amiga and CDTV_ section elsewhere in this guide |
@@ -3799,14 +3800,14 @@ The **@** symbol indicates that the emulator is _deprecated_ and will be removed
 | arduboy               | Arduboy Miniature Game System                  | Arduous                           |                                   | No           | Single archive or .hex file          |
 | astrocde              | Bally Astrocade                                | MAME - Current                    | MAME **(Standalone)**             | Yes          | See the specific _Bally Astrocade_ section elsewhere in this guide |
 | atari2600             | Atari 2600                                     | Stella                            | Stella 2014,<br>Stella **(Standalone)**,<br>Gopher2600 **(Standalone)** [UW],<br>ares **(Standalone)** | No           | Single archive or ROM file |
-| atari5200             | Atari 5200                                     | a5200                             | Atari800,<br>Atari800 **(Standalone)** | Yes          | Single archive or ROM file |
+| atari5200             | Atari 5200                                     | a5200                             | Atari800,<br>Atari800 **(Standalone)**,<br>Altirra **(Standalone)** [W] | Yes except for Altirra | Single archive or ROM file |
 | atari7800             | Atari 7800 ProSystem                           | ProSystem                         | MAME **(Standalone)**             | Yes          | Single archive or ROM file |
-| atari800              | Atari 800                                      | Atari800                          | Atari800 **(Standalone)**         | No           |                                      |
+| atari800              | Atari 800                                      | Atari800                          | Atari800 **(Standalone)**,<br>Altirra **(Standalone)** [W] | Yes except for Altirra |                                      |
 | atarijaguar           | Atari Jaguar                                   | Virtual Jaguar                    | BigPEmu **(Standalone)** [W],<br>BigPEmu **(Wine)** [U],<br>BigPEmu **(Proton)** [U],<br>MAME **(Standalone)** | Yes for MAME | See the specific _Atari Jaguar and Atari Jaguar CD_ section elsewhere in this guide |
 | atarijaguarcd         | Atari Jaguar CD                                | BigPEmu **(Standalone)** [W],<br>BigPEmu **(Wine)** [U] | BigPEmu **(Proton)** [U]   | No           | See the specific _Atari Jaguar and Atari Jaguar CD_ section elsewhere in this guide |
 | atarilynx             | Atari Lynx                                     | Handy                             | Beetle Lynx,<br>Mednafen **(Standalone)** |              |                                      |
 | atarist               | Atari ST [also STE and Falcon]                 | Hatari                            | Hatari **(Standalone)**           | Yes          | Single archive or image file for single-diskette games, .m3u playlist for multi-diskette games |
-| atarixe               | Atari XE                                       | Atari800                          | Atari800 **(Standalone)**         | No           |                                      |
+| atarixe               | Atari XE                                       | Atari800                          | Atari800 **(Standalone)**,<br>Altirra **(Standalone)** [W] | Yes except for Altirra |                                      |
 | atomiswave            | Sammy Corporation Atomiswave                   | Flycast                           | Flycast **(Standalone)**,<br>Flycast Dojo **(Standalone)**,<br>Demul **(Standalone)** [W] | Depends      | Single archive  file                 |
 | bbcmicro              | Acorn Computers BBC Micro                      | MAME **(Standalone)**             |                                   | Yes          | Single archive or diskette image file |
 | c64                   | Commodore 64                                   | VICE x64sc Accurate               | VICE x64sc Accurate **(Standalone)**,<br>VICE x64 Fast,<br>VICE x64 SuperCPU,<br>VICE x128,<br>Frodo | No           | Single archive or image file for tape, cartridge or single-diskette games, .m3u playlist for multi-diskette games |