Documentation update.

CHANGELOG.md

@@ -35,6 +35,8 @@
 * Added the .bin file extension to the gx4000 system
 * Added the .m3u file extension to the pcfx system
 * Removed the .7z and .zip file extensions from the 3do system
+* Set DOSBox-X and DOSBox Staging to start in the game directory so per-game dosbox.conf files can be used
+* (macOS) Added an additional find rule entry for DOSBox-X as the binary name has been changed
 * (Linux) Added Flatpak support for Mednafen using the Mednaffe package
 * (Linux) Added Flatpak support for Solarus using the Solarus Launcher package
 * Added support for folder links, used for launching game files inside folders without having to enter them
@@ -48,6 +50,7 @@
 * Greatly improved the performance of shader post-processing such as scanlines and blur rendering
 * Greatly improved application startup speed by avoiding a lot of unnecessary SVG rasterizations
 * Added support for texture mipmapping with trilinear filtering
+* Added on-demand texture loading to the carousel
 * Improved the renderer scaling accuracy
 * Added new tileSize, tileHorizontalAlignment and tileVerticalAlignment properties to the image element for better tiling support
 * Added support for substituting the emulator binary in staticpath rules with an explicit command (useful for launching specific binaries in Flatpaks)

THEMES-DEV.md

@@ -85,7 +85,8 @@ The following are the most important changes compared to the legacy theme struct
 * Many property names for the carousel have been renamed, with _logo_ being replaced by _item_ as this element can now be used in both the gamelist and system views. As well, setting the alignment will not automatically add any margins as is the case for legacy themes. These can still be set manually using the `horizontalOffset` and `verticalOffset` properties if needed. The way that alignment works in general for both carousel items and the overall carousel has also changed
 * The rating elements were previously not sized and overlaid consistently, this has now been fixed and rating images should now be centered on the image canvas in order for this element to render correctly rather than being left-adjusted as has previously been done by some theme authors (likely as a workaround for the previous buggy implementation). Images of any aspect ratios are now also supported where previously only square images could be used
 * The carousel text element hacks `systemInfo` and `logoText` have been removed and replaced with proper carousel properties
-* The carousel property maxItemCount (formerly named maxLogoCount) is now in float format for more granular control of logo placement compared to integer format for legacy themes. However some legacy theme authors thought this property supported floats (as the theme documentation incorrectly stated this) and have therefore set it to fractional values such as 3.5. This was actually rounded up when loading the theme configuration, and this logic is retained for legacy themes for backward compatibility. But for current themes the float value is correctly interpreted which means a manual rounding of the value is required in order to retain an identical layout when porting theme sets to the new theme engine. As well carousels of the wheel type now have the amount of entries controlled by the two new properties `itemsBeforeCenter` and `itemsAfterCenter`. This provides more exact control, including the ability to setup asymmetric wheels.
+* The carousel property `maxItemCount` (formerly named maxLogoCount) is now in float format for more granular control of logo placement compared to integer format for legacy themes. However some legacy theme authors thought this property supported floats (as the theme documentation incorrectly stated this) and have therefore set it to fractional values such as 3.5. This was actually rounded up when loading the theme configuration, and this logic is retained for legacy themes for backward compatibility. But for current themes the float value is correctly interpreted which means a manual rounding of the value is required in order to retain an identical layout when porting theme sets to the new theme engine. As well carousels of the wheel type now have the amount of entries controlled by the two new properties `itemsBeforeCenter` and `itemsAfterCenter`. This provides more exact control, including the ability to setup asymmetric wheels.
+* The carousel now has a zIndex value of 50 instead of 40. This means it's aligned with the textlist element which already had a zIndex value of 50.
 * The helpsystem `textColorDimmed` and `iconColorDimmed` properties (which apply when opening a menu) were always defined under the system view configuration which meant these properties could not be separately set for the gamelist views. Now these properties work as expected with the possibility to configure separate values for the system and gamelist views
 * Correct theme structure is enforced more strictly than before, and deviations will generate error log messages and make the theme loading fail
 * Many additional elements and properties have been added, refer to the [Reference](THEMES-DEV.md#reference) section for more information

USERGUIDE-DEV.md

@@ -1198,6 +1198,8 @@ The second approach for DOS games is to keep the directory structure intact for
 
 When going for this approach the game folders can be scraped so that it looks nice when browsing the gamelist, but make sure to also scrape the files used to launch the games or otherwise their entries in the collections _All games, Favorites_ and _Last played_ as well as any custom collections will miss the game metadata and game media. If you don't have these collections activated, then this can of course be skipped.
 
+Regardless of game setup method, per-game settings can be applied. If using the DOSBox RetroArch cores this is done via the RetroArch GUI and for DOSBox-X and DOSBox Staging it's accomplished by placing a custom dosbox.conf in the game directory.
+
 #### ScummVM
 
 ScummVM overlaps a bit with DOS when it comes to the logic of setting it up. It's recommended to keep games in separate folders, so if you have a game distributed as a ZIP file, uncompress it to its own directory.
@@ -1865,7 +1867,7 @@ Apart from this, hopefully the scraping process should be self-explanatory.
 
 ### Manually copying game media files
 
-If you already have a library of game media (images and videos) you can manually copy these files into ES-DE.
+If you already have a library of game media (images and videos) you can manually copy these files into ES-DE. The same procedure applies if you want to add media for individual games, for instance when the scraper did not return any results or if you didn't like the media it provided.
 
 The default media directory is `~/.emulationstation/downloaded_media/<system name>/<media type>`
 
@@ -1884,12 +1886,18 @@ An example on macOS:
 /Users/myusername/.emulationstation/downloaded_media/c64/screenshots/
 ```
 
-An example on Windows:
+An example on Windows (installer release):
 
 ```
 C:\Users\Myusername\.emulationstation\downloaded_media\c64\screenshots\
 ```
 
+An example on Windows (portable release):
+
+```
+EmulationStation-DE\.emulationstation\downloaded_media\c64\screenshots\
+```
+
 The media directories per game system are:
 
 * 3dboxes

USERGUIDE.md

@@ -1818,7 +1818,7 @@ Apart from this, hopefully the scraping process should be self-explanatory.
 
 ### Manually copying game media files
 
-If you already have a library of game media (images and videos) you can manually copy these files into ES-DE.
+If you already have a library of game media (images and videos) you can manually copy these files into ES-DE. The same procedure applies if you want to add media for individual games, for instance when the scraper did not return any results or if you didn't like the media it provided.
 
 The default media directory is `~/.emulationstation/downloaded_media/<system name>/<media type>`
 
@@ -1837,7 +1837,17 @@ An example on macOS:
 /Users/myusername/.emulationstation/downloaded_media/c64/screenshots/
 ```
 
-An example on Windows:
+An example on Windows (installer release):
+
+```
+C:\Users\Myusername\.emulationstation\downloaded_media\c64\screenshots\
+```
+
+An example on Windows (portable release):
+
+```
+EmulationStation-DE\.emulationstation\downloaded_media\c64\screenshots\
+```
 
 The media directories per game system are: