From c32d4e32ed7df00714dc1e12f6b8c7dec32c4e92 Mon Sep 17 00:00:00 2001 From: Sebastian Wick Date: Thu, 10 Oct 2024 14:03:47 +0200 Subject: [PATCH] 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. --- data/org.freedesktop.portal.Settings.xml | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/data/org.freedesktop.portal.Settings.xml b/data/org.freedesktop.portal.Settings.xml index d8ff315f4..861086da9 100644 --- a/data/org.freedesktop.portal.Settings.xml +++ b/data/org.freedesktop.portal.Settings.xml @@ -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``) @@ -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. -->