From dab35970ab72b7b55fd57f709367ec43654d83df Mon Sep 17 00:00:00 2001 From: Leon Styhre Date: Sun, 24 Nov 2024 17:50:02 +0100 Subject: [PATCH] Documentation update --- CHANGELOG.md | 2 ++ USERGUIDE-DEV.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 42fcde110..59d7e823c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -24,6 +24,7 @@ In addition to the above there are a number of bug fixes and other minor improve * (Android) Changed the default audio driver from AAudio to OpenSL ES * (Android) Added an audio driver menu option to the Sound settings menu * (Android) Added experimental support for running in multi-window mode +* (Android) Directories for corrupt themes are now automatically removed when the theme downloader is started * (Android) Added experimental support for the Nintendo Wii U (wiiu) game system * (Android) Changed Flycast standalone to use %ROMSAF% instead of %ROM% as the latter caused game launching to fail on some devices * (Android) Adjusted the layout for the onboarding configurator to look better on screens with wider aspect ratios @@ -34,6 +35,7 @@ In addition to the above there are a number of bug fixes and other minor improve * (Android) Removed the built-in application update check for the Samsung Galaxy Store and Huawei AppGallery builds * (Windows) Added Yaba Sanshiro 2 standalone as an alternative emulator for the saturn and saturnjp systems * (Windows) Added a find rule for the SSE2 build of DuckStation +* Added support to the theme downloader for detecting and handling theme repository URL changes * Added a "textBackgroundCornerRadius" property to the carousel element * Added a "textBackgroundCornerRadius" property to the grid element * Made the "backgroundCornerRadius" and "selectorCornerRadius" properties for the grid element apply also to colored rectangles diff --git a/USERGUIDE-DEV.md b/USERGUIDE-DEV.md index 1cb46c6fc..339b70aad 100644 --- a/USERGUIDE-DEV.md +++ b/USERGUIDE-DEV.md @@ -602,6 +602,8 @@ Themes are downloaded from their respective GitHub or GitLab sites using _Git_ ( If you have manually downloaded any of the themes from the [official themes list](https://gitlab.com/es-de/themes/themes-list) then these would need to be downloaded again as they will not contain the necessary information required by the theme downloader. A dialog will be presented to inform you about this and the theme directory will be renamed by adding the _DISABLED extension to its name. To conserve disk space it's a good idea to manually delete these _DISABLED directories outside of ES-DE. Alternatively you could just completely delete the theme from the user interface using the _Y_ button and start a fresh download. +On Android specifically all theme directories that were previously renamed with _DISABLED are automatically deleted every time the theme downloader is started. This is the case as Android prevents direct access to the theme directory due to it being located on application-internal storage, meaning it's not possible to manually delete these directories. + If you have customized a theme by for instance modifying any of its XML files, then this will be highlighted with an exclamation mark and the text _LOCAL CHANGES_ in the theme downloader interface. If you attempt to fetch updates for such a theme you will be asked a question of whether to overwrite your local changes, or whether to cancel. If you have however added additional files to the theme that are not included in the theme repository, then these will not interfere and you can go ahead and fetch theme updates without any risk of having your local files being deleted. But there is a special (although unlikely) situation, if you add files that are not part of the theme repository but that are later added by the theme developer as well, then your local copies of any such files will be ovewritten when fetching theme updates. In worst case there could be a situation where a repository is corrupted and the theme downloader can't properly identify or handle the corruption. In this case you will have to rename or delete that directory. This could also apply to the actual themes list repository. The latter is named _themes-list_ so by just deleting this directory (i.e. `~/ES-DE/themes/themes-list`) you'll reset the theme downloader to its initial state.