From 0a069e16439aa95bf55acf1816c35d73820091de 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 8119f236a2..9a9376ba64 100644
--- 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>