Documentation update

CHANGELOG.md

@@ -52,11 +52,14 @@
 * Added the .elf, .tmd and .wuhb file extensions to the wiiu system on Linux, macOS and Windows
 * (Android) Added %GAMEDIRRAW%, %ROMPATHRAW% and %ROMRAW% variables that can be used with the %EXTRA% and %EXTRAARRAY% variables
 * Added a "selectedItemOffset" property to the carousel element
+* Added a "selectedBackgroundMargins" property to the textlist element
+* Added a "backgroundMargins" property to the text element
 * (macOS) Changed the minimum required OS version from 10.15 "Catalina" to 11 "Big Sur"
 
 ### Bug fixes
 
 * Adding trailing directory separators to the MediaDirectory setting could make the Orphaned data cleanup utility remove too many files
+* There could be minor textlist selector clipping issues if the selector had a text background color set
 
 ## Version 3.0.2 / 3.0.2-21
 

THEMES-DEV.md

@@ -1527,7 +1527,7 @@ Properties:
     - Default is `0 0`
     - This property can only be used when `type` is `horizontal` or `vertical`
 * `selectedItemOffset` - type: NORMALIZED_PAIR
-    - Offsets the selected item. The first value in the pair is the horizontal offset and the second value is the vertical offset. Applied after all other positioning calculations.
+    - Offsets the selected item. The first value of the pair is the horizontal offset and the second value is the vertical offset. Applied after all other positioning calculations.
     - Minimum value per axis is `-1` and maximum value per axis is `1`
     - Default is `0 0`
     - This property can only be used when `type` is `horizontal` or `vertical`
@@ -2061,6 +2061,11 @@ Properties:
 * `selectedSecondaryBackgroundColor` - type: COLOR
     - Background color of the highlighted entry for the secondary entry type. This follows the sizing of the selector bar and is expanded downwards so you'll probably want to adjust its position using `selectorVerticalOffset` if you have defined a custom selector height using `selectorHeight`
     - Default is the same value as `selectedBackgroundColor`
+* `selectedBackgroundMargins` - type: NORMALIZED_PAIR
+    - Adds margins to the selected text background, assuming it has a color set. The first value of the pair is the left margin and the second value is the right margin, which means it's possible to set these margins completely independently. Margins are applied after all other positioning and sizing calculations and they are rendered outside the text debug rectangle boundaries.
+    - Minimum value per axis is `0` and maximum value per axis is `0.5`
+    - Default is `0 0`
+    - This property can only be used if `selectedBackgroundColor` or `selectedSecondaryBackgroundColor` has a value defined.
 * `textHorizontalScrolling` - type: BOOLEAN
     - If this property is enabled then text that does not fit within the element width (minus margins) will scroll horizontally. If the property is disabled, the text will instead be truncated with an ellipsis (...). Using this property will automatically convert all line breaks to spaces so that a single line of text is always displayed.
     - Valid values are `vertical` or `horizontal`
@@ -2820,6 +2825,11 @@ Properties:
     - Default is `000000FF`
 * `backgroundColor` - type: COLOR
     - Default is `00000000`
+* `backgroundMargins` - type: NORMALIZED_PAIR
+    - Adds margins to the text background, assuming it has a color set. The first value of the pair is the left margin and the second value is the right margin, which means it's possible to set these margins completely independently. Margins are applied after all other positioning and sizing calculations and they are rendered outside the text debug rectangle boundaries.
+    - Minimum value per axis is `0` and maximum value per axis is `0.5`
+    - Default is `0 0`
+    - This property can only be used if `backgroundColor` has a value defined.
 * `letterCase` - type: STRING
     - Valid values are `none`, `uppercase`, `lowercase` or `capitalize`
     - Default is `none` (original letter case is retained)

USERGUIDE-DEV.md

@@ -1598,9 +1598,7 @@ To map the controller to the keyboard and to set a 33 MHz CPU speed, the file co
 
 ### LaserDisc Games
 
-Note that on Android the Hypseus Singe emulator is not available. However the setup for MAME (using MAME4droid 2024) and DirkSimple still applies.
+Note that on Android the Hypseus Singe emulator is not available. However the setup for MAME (using MAME4droid 2024) and DirkSimple still applies. If using Android also make sure you've read the _MAME4droid 2024 and MAME4droid_ section of the [Android documentation](ANDROID-DEV#mame4droid-2024-and-mame4droid) and that your ROM directory is configured correctly inside the emulator.
-
-If using Android then make sure you've read the _MAME4droid 2024 and MAME4droid_ section of the [Android documentation](ANDROID-DEV#mame4droid-2024-and-mame4droid) and that your ROM directory is configured correctly inside the emulator.
 
 There are three ways to run LaserDisc games in ES-DE, via MAME, via Hypseus Singe or via the DirkSimple RetroArch core. There are also two separate systems available, _daphne_ and _laserdisc_. The latter is recommended as the _daphne_ system is mostly existing for legacy reasons and may be removed in a future ES-DE release. The configuration for these two systems is identical as they are essentially clones.