From 1c5ff520407c2a25dee4c9247408667e5908f69b Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 29 Aug 2005 20:24:49 +0000
Subject: [PATCH] Add a long description.

2005-08-29  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkstatusicon.sgml: Add a long description.
---
 docs/reference/ChangeLog                   |   2 +
 docs/reference/gtk/tmpl/gtkstatusicon.sgml | 217 +++++++++++++++++++++
 2 files changed, 219 insertions(+)
 create mode 100644 docs/reference/gtk/tmpl/gtkstatusicon.sgml

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index a6761dd46b..53691e6456 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,7 @@
 2005-08-29  Matthias Clasen  <mclasen@redhat.com>
 
+	* gtk/tmpl/gtkstatusicon.sgml: Add a long description.
+
 	* gtk/Makefile.am (HTML_IMAGES): Add stock_select_all_24.png
 	
 	* gtk/gtk-sections.txt: 
diff --git a/docs/reference/gtk/tmpl/gtkstatusicon.sgml b/docs/reference/gtk/tmpl/gtkstatusicon.sgml
new file mode 100644
index 0000000000..512bfad3d1
--- /dev/null
+++ b/docs/reference/gtk/tmpl/gtkstatusicon.sgml
@@ -0,0 +1,217 @@
+<!-- ##### SECTION Title ##### -->
+GtkStatusIcon
+
+<!-- ##### SECTION Short_Description ##### -->
+Display an icon in the system tray
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+The "system tray" or notification area is normally used for transient icons 
+that indicate some special state. For example, a system tray icon might 
+appear to tell the user that they have new mail, or have an incoming instant 
+message, or something along those lines. The basic idea is that creating an 
+icon in the notification area is less annoying than popping up a dialog. 
+</para>
+
+<para>
+A #GtkStatusIcon object can be used to display an icon in a "system tray".
+The icon can have a tooltip, and the user can interact with it by
+activating it or popping up a context menu. Critical information should
+not solely be displayed in a #GtkStatusIcon, since it may not be
+visible (e.g. when the user doesn't have a notification area on his panel).
+This can be checked with gtk_status_icon_is_embedded().
+</para>
+
+<para>
+On X11, the implementation follows the freedesktop.org "System Tray" 
+<ulink url="http://www.freedesktop.org/wiki/Standards/systemtray-spec">specification</ulink>. Implementations of the "tray" side of this specification can
+be found e.g. in the GNOME and KDE panel applications.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION gtk_status_icon_new ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_new_from_pixbuf ##### -->
+<para>
+
+</para>
+
+@pixbuf: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_new_from_file ##### -->
+<para>
+
+</para>
+
+@filename: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_new_from_stock ##### -->
+<para>
+
+</para>
+
+@stock_id: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_new_from_icon_name ##### -->
+<para>
+
+</para>
+
+@icon_name: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_set_from_pixbuf ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@pixbuf: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_set_from_file ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@filename: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_set_from_stock ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@stock_id: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_set_from_icon_name ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@icon_name: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_get_storage_type ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_get_pixbuf ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_get_stock ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_get_icon_name ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_get_size ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_set_tooltip ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@tooltip_text: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_set_visible ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@visible: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_get_visible ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_set_blinking ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@blinking: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_get_blinking ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_status_icon_is_embedded ##### -->
+<para>
+
+</para>
+
+@status_icon: 
+@Returns: 
+
+