Skip to content

Commit

Permalink
settings: Make the text about non-standardized keys prominent
Browse files Browse the repository at this point in the history
Explicitly calls the keys which we document "standardized keys" and
moves the text about non-standardized keys closer to that and before the
list of keys so it's harder to miss.
  • Loading branch information
swick authored and GeorgesStavracas committed Oct 10, 2024
1 parent aca3fd1 commit c32d4e3
Showing 1 changed file with 8 additions and 8 deletions.
16 changes: 8 additions & 8 deletions data/org.freedesktop.portal.Settings.xml
Original file line number Diff line number Diff line change
Expand Up @@ -25,11 +25,15 @@
org.freedesktop.portal.Settings:
@short_description: Settings interface
This interface provides read-only access to a small number
of host settings required for toolkits similar to XSettings.
It is not for general purpose settings.
This interface provides read-only access to a small number of standardized
host settings required for toolkits similar to XSettings. It is not for
general purpose settings.
Currently the interface provides the following keys:
Implementations can provide keys not listed below; they are entirely
implementation details that are undocumented. If you are a toolkit and want
to use this please open an issue.
Currently the interface provides the following standardized keys:
* ``org.freedesktop.appearance`` ``color-scheme`` (``u``)
Expand Down Expand Up @@ -58,10 +62,6 @@
Unknown values should be treated as ``0`` (no preference).
Implementations can provide other keys; they are entirely
implementation details that are undocumented. If you are a
toolkit and want to use this please open an issue.
This documentation describes version 2 of this interface.
-->
<interface name="org.freedesktop.portal.Settings">
Expand Down

0 comments on commit c32d4e3

Please sign in to comment.