Skip to content

Commit 7ed0953

Browse files
committed
desktop-integration: Make themeing intro clearer
Closes #584
1 parent 20d7e52 commit 7ed0953

File tree

1 file changed

+12
-8
lines changed

1 file changed

+12
-8
lines changed

docs/desktop-integration.rst

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@ using, it may need session bus ownership of ``org.kde.StatusNotifierItem-$PID-$I
8888

8989
This permission is problematic in Flatpak as the ``$PID`` value is often the same
9090
in sandboxes, leading to potential conflicts with other applications.
91-
However, if needed, the ``--own-name=org.kde.*`` permission will allow this.
91+
However, if needed, the ``--own-name=org.kde.*`` permission will allow this.
9292

9393
.. warning::
9494
This introduces many new risks, including the ability to impersonate any KDE
@@ -146,13 +146,17 @@ it will work as expected within a sandboxed application.
146146
Theming
147147
-------
148148

149-
Flatpak applications cannot directly use the system theme because flatpaks
150-
do not have access to data files or libraries in ``/usr`` (where system
151-
themes are typically located). The solution is to package themes as
152-
flatpaks; relying on the host to have the correct version for every
153-
flatpak defeats the portability benefits Flatpak provides. These themes are
154-
provided as :doc:`extension` to the Freedesktop runtime for Gtk3 themes
155-
and to the KDE runtime for Qt themes.
149+
Flatpak applications cannot directly use the system theme from the host
150+
as the ``/usr`` directory inside the sandbox is reserved by the runtime,
151+
and host's ``/usr`` where system themes are typically stored cannot be
152+
made available over that. Additionally, themes often depend on
153+
specific toolkit versions, which may differ between the host and the
154+
runtime. Relying on the host to have the correct version for every
155+
flatpak also defeats the portability benefits Flatpak provides.
156+
157+
The solution to this is to package the themes as flatpaks. These themes
158+
are provided as :doc:`extension` to the Freedesktop runtime for Gtk3
159+
themes and to the KDE runtime for Qt themes.
156160

157161
The theming system requires Flatpak 0.8.4+ and applications using
158162
up-to-date ``org.gnome.Platform`` 3.24+, ``org.freedesktop.Platform`` 1.6+,

0 commit comments

Comments
 (0)