Document DESKTOP_STARTUP_ID use

Closes https://bugzilla.gnome.org/show_bug.cgi?id=165987

diff --git a/docs/reference/gtk/running.sgml b/docs/reference/gtk/running.sgml
index 8119f236a2fdeab1a71c6b1eb3df6f6ff11b138a..9a9376ba64e030cbac51cde3d758db2f8623fb8d 100644 (file)
--- a/docs/reference/gtk/running.sgml
+++ b/docs/reference/gtk/running.sgml
@@ -389,6 +389,19 @@ nevertheless.
   </para>
 </formalpara>
 
+<formalpara>
+  <title><envar>DESKTOP_STARTUP_ID</envar></title>
+
+  <para>
+    GTK+ uses this environment variable to provide startup notification
+    according to the <ulink url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">Startup Notification Spec</ulink>.
+    Following the specification, GTK+ unsets this variable after reading
+    it (to keep it from leaking to child processes). So, if you need its
+    value for your own purposes, you have to read it before calling
+    gtk_init().
+  </para>
+</formalpara>
+
 </refsect2>
 
 </refsect1>