From 2687db1e17d3d8fe4539da7f584b1d2e6681da64 Mon Sep 17 00:00:00 2001 From: Leon Styhre Date: Mon, 25 Dec 2023 13:16:44 +0100 Subject: [PATCH] Documentation update --- CHANGELOG.md | 6 +++++- INSTALL-DEV.md | 13 ++++++++++++- USERGUIDE-DEV.md | 2 +- 3 files changed, 18 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4928ad587..7d401b9e2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,6 +17,7 @@ * Added support for .webp, .svg and unanimated .gif files to the slideshow screensaver when using a custom image directory * Changed the default slideshow custom image directory from slideshow/custom_images to screensavers/custom_slideshow * Changed the custom slideshow image directory setting from ScreensaverSlideshowImageDir to ScreensaverSlideshowCustomDir +* The HTTP error code will now be shown on scraper errors instead of the "File is smaller than 350 bytes" message * Added Mednafen standalone as an alternative emulator for the gb, gba and gbc systems * (Linux) Added support for the AppImage release of Vita3K * Added the .zso file extension to the ps2 system @@ -28,13 +29,16 @@ * (Windows) Added the %RUNINBACKGROUND% variable for the epic system * (Windows) Removed support for building the application using MinGW * Added a "renderDuringTransitions" property to the image element +* Placeholder entries in es_systems.xml are now skipped by default when creating the system directories and systemsinfo.txt files +* Added a CreatePlaceholderSystemDirectories option that can be manually set in es_settings.xml to still create placeholder directories * Added support for more extreme vertical resolutions than previously allowed * Added support for the 19.5:9, 20:9 and 1:1 display aspect ratios -* The SDL error message is now printed to the log if a controller could not be added +* The relevant SDL error message is now printed to the log if a controller could not be added * Added workarounds for some mobile GPUs which do not support all OpenGL operations when using the BGRA pixel format ### Bug fixes +* Attempting to create the system directories with invalid entries in es_systems.xml could crash the application * Stationary image elements could sometimes glitch out during carousel navigation * Font textures were sometimes updated with empty glyhps which generated OpenGL errors on some mobile GPUs diff --git a/INSTALL-DEV.md b/INSTALL-DEV.md index 81f91cfd7..a98a978bc 100644 --- a/INSTALL-DEV.md +++ b/INSTALL-DEV.md @@ -1048,7 +1048,7 @@ Setting --resolution to a lower or higher value than the display resolution will The --no-update-check option only disabled the application updater for the current startup. To permanently disable this functionality use the _Check for application updates_ option in the _Other settings_ menu. The command line option is primarily intended for the unlikely event that the application updater breaks the application and makes it impossible to start. -Running with the --create-system-dirs option will generate all the game system directories in the ROMs folder. This is equivalent to starting ES-DE with no game ROMs present and pressing the _Create directories_ button. Detailed output for the directory creation will be available in es_log.txt and the application will quit immediately after the directories have been created. +Running with the --create-system-dirs option will generate all the game system directories in the ROMs folder. This is equivalent to starting ES-DE with no game ROMs present and pressing the _Create directories_ button. Detailed output for the directory creation will be available in es_log.txt and the application will quit immediately after the directories have been created. By default placeholder entries will be skipped, if you want to still create these directories then set the CreatePlaceholderSystemDirectories option to true in es_settings.xml. For the following options, the es_settings.xml file is immediately updated/saved when passing the parameter: ``` @@ -1069,6 +1069,10 @@ The --ignore-gamelist option is only active during the program session and is no There are some settings which are not configurable via the GUI as modifying these should normally not be required. To still change these, edit the es_settings.xml file directly. +**CreatePlaceholderSystemDirectories** + +If a system in es_systems.xml has a single command tag with the text _PLACEHOLDER_ anywhere in the tag (regardless of letter case) then its directory and _systeminfo.txt_ file will not get created when running with the --create-system-dirs command line option, or when using the _Create/update system directories_ entry in the _Utilities_ menu or when pressing the _Create directories_ button in the no-games startup dialog. However setting this option to true will override the behavior so the placeholder directories will still be created. + **DebugSkipInputLogging** Enabling this will skip all input event logging (button and key presses). Default value is false. @@ -1500,6 +1504,13 @@ Below is an overview of the file layout with various examples. For the command t and %ESCAPESPECIALS% escapes the characters &()^=;, that cmd.exe can't otherwise handle. --> %HIDEWINDOW% %ESCAPESPECIALS% %RUNINBACKGROUND% cmd.exe /C %ROM% + + PLACEHOLDER %ROM% +