gtk+ r21944 - in trunk: . gtk

[matthiasc svn gnome org]

Author: matthiasc
Date: Sat Dec 27 05:35:09 2008
New Revision: 21944
URL: http://svn.gnome.org/viewvc/gtk+?rev=21944&view=rev

Log:
More docs


Modified:
   trunk/ChangeLog
   trunk/gtk/gtkentry.c

Modified: trunk/gtk/gtkentry.c
==============================================================================
--- trunk/gtk/gtkentry.c	(original)
+++ trunk/gtk/gtkentry.c	Sat Dec 27 05:35:09 2008
@@ -998,9 +998,11 @@
    *
    * Whether the primary icon is activatable.
    *
-   * GTK+ emits the #GtkEntry::icon-pressed and
-   * #GtkEntry::icon-released signals only on
-   * sensitive, activatable icons.
+   * GTK+ emits the #GtkEntry::icon-pressed and #GtkEntry::icon-released 
+   * signals only on sensitive, activatable icons. 
+   *
+   * Sensitive, but non-activatable icons can be used for purely 
+   * informational purposes.
    *
    * Since: 2.16
    */
@@ -1017,9 +1019,11 @@
    *
    * Whether the secondary icon is activatable.
    *
-   * GTK+ emits the #GtkEntry::icon-pressed and
-   * #GtkEntry::icon-released signals only on
-   * sensitive, activatable icons.
+   * GTK+ emits the #GtkEntry::icon-pressed and #GtkEntry::icon-released 
+   * signals only on sensitive, activatable icons.
+   *
+   * Sensitive, but non-activatable icons can be used for purely 
+   * informational purposes.
    *
    * Since: 2.16
    */
@@ -1037,9 +1041,13 @@
    *
    * Whether the primary icon is sensitive.
    *
-   * An insensitive icon will appear grayed out, it will not emit
-   * #GtkEntry::icon-pressed signal, not allow DND and not change the cursor.
+   * An insensitive icon appears grayed out. GTK+ does not emit the 
+   * #GtkEntry::icon-pressed and #GtkEntry::icon-released signals and 
+   * does not allow DND from insensitive icons.
    *
+   * An icon should be set insensitive if the action that would trigger
+   * when clicked is currently not available.
+   * 
    * Since: 2.16
    */
   g_object_class_install_property (gobject_class,
@@ -1055,8 +1063,12 @@
    *
    * Whether the secondary icon is sensitive.
    *
-   * An insensitive icon will appear grayed out, it will not emit
-   * #GtkEntry::icon-pressed signal, not allow DND and not change the cursor.
+   * An insensitive icon appears grayed out. GTK+ does not emit the 
+   * #GtkEntry::icon-pressed and #GtkEntry::icon-released signals and 
+   * does not allow DND from insensitive icons.
+   *
+   * An icon should be set insensitive if the action that would trigger
+   * when clicked is currently not available.
    *
    * Since: 2.16
    */
@@ -1189,7 +1201,8 @@
    * @icon_pos: The position of the clicked icon
    * @event: the button press event
    *
-   * The ::icon-pressed signal is emitted when an icon is clicked.
+   * The ::icon-pressed signal is emitted when an activatable icon 
+   * is clicked.
    *
    * Since: 2.16
    */
@@ -1211,7 +1224,7 @@
    * @event: the button release event
    *
    * The ::icon-released signal is emitted on the button release from a
-   * mouse click.
+   * mouse click over an activatable icon.
    *
    * Since: 2.16
    */
@@ -7595,7 +7608,8 @@
  *
  * Use %NULL for @tooltip to remove an existing tooltip.
  *
- * See also gtk_widget_set_tooltip_text().
+ * See also gtk_widget_set_tooltip_text() and 
+ * gtk_entry_set_icon_tooltip_markup().
  *
  * Since: 2.16
  */
@@ -7635,7 +7649,8 @@
  *
  * Use %NULL for @tooltip to remove an existing tooltip.
  *
- * See also gtk_widget_set_tooltip_markup().
+ * See also gtk_widget_set_tooltip_markup() and 
+ * gtk_enty_set_icon_tooltip_text().
  *
  * Since: 2.16
  */
@@ -7665,10 +7680,10 @@
 
 static gboolean
 gtk_entry_query_tooltip (GtkWidget  *widget,
-                              gint        x,
-                              gint        y,
-                              gboolean    keyboard_tip,
-                              GtkTooltip *tooltip)
+                         gint        x,
+                         gint        y,
+                         gboolean    keyboard_tip,
+                         GtkTooltip *tooltip)
 {
   GtkEntry *entry;
   GtkEntryPrivate *priv;