[gtk+/gtk-2-24] Document DESKTOP_STARTUP_ID use

[Matthias Clasen <matthiasc src gnome org>]

commit fda64442164fc7b2d8e1013bf3deeaf9c6ced8bf
Author: Matthias Clasen <mclasen redhat com>
Date:   Tue Jan 4 10:58:04 2011 -0500

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

 docs/reference/gtk/running.sgml |   13 +++++++++++++
 1 files changed, 13 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gtk/running.sgml b/docs/reference/gtk/running.sgml
index add364f..1d8d2f8 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>