summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGuido Günther <agx@sigxcpu.org>2018-08-02 11:03:41 +0200
committerGuido Günther <agx@sigxcpu.org>2018-08-02 11:10:21 +0200
commitf25f3b3c47db97686f7ad396f16ad7d4976f089f (patch)
tree60cd17374ffb98f5cb659512d43bd4dcd080a627
parent72ec8963d7df0e39f688838e42445c869e4875c9 (diff)
downloadgtk+-f25f3b3c47db97686f7ad396f16ad7d4976f089f.tar.gz
docs: Explain desktop file id == application_id in migration guide
-rw-r--r--docs/reference/gtk/migrating-3to4.xml16
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index cd113bb79b..6532974d3c 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -177,6 +177,22 @@
</para>
</section>
+ <section>
+ <title>Set a proper app_id</title>
+ <para>
+ In GTK+4 we want the application's #GApplication
+ 'application-id' (and therefore the D-Bus name), the desktop
+ file basename and Wayland's xdg-shell app_id to match. In
+ order to achieve this with GTK+3 call g_set_prgname() with the same
+ application id you passed to #GtkApplication. Rename your
+ desktop files to match the application id if needed.
+ </para>
+ <para>
+ The call to g_set_prgname() can be removed once you fully migrated
+ to GTK+4.
+ </para>
+ </section>
+
</section>
<section>