Skip to content

Commit c32d4e3

Browse files
swickGeorgesStavracas
authored andcommitted
settings: Make the text about non-standardized keys prominent
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.
1 parent aca3fd1 commit c32d4e3

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

data/org.freedesktop.portal.Settings.xml

+8-8
Original file line numberDiff line numberDiff line change
@@ -25,11 +25,15 @@
2525
org.freedesktop.portal.Settings:
2626
@short_description: Settings interface
2727
28-
This interface provides read-only access to a small number
29-
of host settings required for toolkits similar to XSettings.
30-
It is not for general purpose settings.
28+
This interface provides read-only access to a small number of standardized
29+
host settings required for toolkits similar to XSettings. It is not for
30+
general purpose settings.
3131
32-
Currently the interface provides the following keys:
32+
Implementations can provide keys not listed below; they are entirely
33+
implementation details that are undocumented. If you are a toolkit and want
34+
to use this please open an issue.
35+
36+
Currently the interface provides the following standardized keys:
3337
3438
* ``org.freedesktop.appearance`` ``color-scheme`` (``u``)
3539
@@ -58,10 +62,6 @@
5862
5963
Unknown values should be treated as ``0`` (no preference).
6064
61-
Implementations can provide other keys; they are entirely
62-
implementation details that are undocumented. If you are a
63-
toolkit and want to use this please open an issue.
64-
6565
This documentation describes version 2 of this interface.
6666
-->
6767
<interface name="org.freedesktop.portal.Settings">

0 commit comments

Comments
 (0)