From fda64442164fc7b2d8e1013bf3deeaf9c6ced8bf Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Tue, 4 Jan 2011 10:58:04 -0500
Subject: [PATCH] Document DESKTOP_STARTUP_ID use

Closes https://bugzilla.gnome.org/show_bug.cgi?id=165987
---
 docs/reference/gtk/running.sgml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/reference/gtk/running.sgml b/docs/reference/gtk/running.sgml
index add364f173..1d8d2f86d2 100644
--- a/docs/reference/gtk/running.sgml
+++ b/docs/reference/gtk/running.sgml
@@ -392,6 +392,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>