GtkTextView: don't popdown a bubble if we don't have one

[~andy/gtk] / gtk / gtkrecentchooser.h

diff --git a/gtk/gtkrecentchooser.h b/gtk/gtkrecentchooser.h
index a30b78f69eef7fe91f36fdeca4643eb36030dd87..66626ca9664dbc2246906536a054eb1d98883ac8 100644 (file)
--- a/gtk/gtkrecentchooser.h
+++ b/gtk/gtkrecentchooser.h
@@ -2,7 +2,7 @@
  * gtkrecentchooser.h - Abstract interface for recent file selectors GUIs
  *
  * Copyright (C) 2006, Emmanuele Bassi
- * 
+ *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -14,22 +14,19 @@
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
  */
 
-#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
-#error "Only <gtk/gtk.h> can be included directly."
-#endif
-
 #ifndef __GTK_RECENT_CHOOSER_H__
 #define __GTK_RECENT_CHOOSER_H__
 
-#include <gtk/gtkwidget.h>
+#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
+#error "Only <gtk/gtk.h> can be included directly."
+#endif
 
-#include "gtkrecentmanager.h"
-#include "gtkrecentfilter.h"
+#include <gtk/gtkwidget.h>
+#include <gtk/gtkrecentmanager.h>
+#include <gtk/gtkrecentfilter.h>
 
 G_BEGIN_DECLS
 
@@ -47,11 +44,13 @@ G_BEGIN_DECLS
  * @GTK_RECENT_SORT_LRU: Sort the returned list with the least recently used
  *   items first.
  * @GTK_RECENT_SORT_CUSTOM: Sort the returned list using a custom sorting
- *   function passed using gtk_recent_manager_set_sort_func().
+ *   function passed using gtk_recent_chooser_set_sort_func().
  *
  * Used to specify the sorting method to be applyed to the recently
  * used resource list.
- **/
+ *
+ * Since: 2.10
+ */
 typedef enum
 {
   GTK_RECENT_SORT_NONE = 0,
@@ -68,8 +67,25 @@ typedef gint (*GtkRecentSortFunc) (GtkRecentInfo *a,
 typedef struct _GtkRecentChooser      GtkRecentChooser; /* dummy */
 typedef struct _GtkRecentChooserIface GtkRecentChooserIface;
 
+/**
+ * GTK_RECENT_CHOOSER_ERROR:
+ *
+ * Used to get the #GError quark for #GtkRecentChooser errors.
+ *
+ * Since: 2.10
+ */
 #define GTK_RECENT_CHOOSER_ERROR       (gtk_recent_chooser_error_quark ())
 
+/**
+ * GtkRecentChooserError:
+ * @GTK_RECENT_CHOOSER_ERROR_NOT_FOUND: Indicates that a file does not exist
+ * @GTK_RECENT_CHOOSER_ERROR_INVALID_URI: Indicates a malformed URI
+ *
+ * These identify the various errors that can occur while calling
+ * #GtkRecentChooser functions.
+ *
+ * Since: 2.10
+ */
 typedef enum
 {
   GTK_RECENT_CHOOSER_ERROR_NOT_FOUND,
@@ -82,7 +98,7 @@ GQuark  gtk_recent_chooser_error_quark (void);
 struct _GtkRecentChooserIface
 {
   GTypeInterface base_iface;
-  
+
   /*
    * Methods
    */
@@ -106,9 +122,9 @@ struct _GtkRecentChooserIface
   GSList *          (* list_filters)       (GtkRecentChooser  *chooser);
   void              (* set_sort_func)      (GtkRecentChooser  *chooser,
                                            GtkRecentSortFunc  sort_func,
-                                           gpointer           data,
-                                           GDestroyNotify     destroy);
-  
+                                           gpointer           sort_data,
+                                           GDestroyNotify     data_destroy);
+
   /*
    * Signals
    */
@@ -139,11 +155,6 @@ gboolean          gtk_recent_chooser_get_local_only      (GtkRecentChooser  *cho
 void              gtk_recent_chooser_set_show_tips       (GtkRecentChooser  *chooser,
                                                          gboolean           show_tips);
 gboolean          gtk_recent_chooser_get_show_tips       (GtkRecentChooser  *chooser);
-#ifndef GTK_DISABLE_DEPRECATED
-void              gtk_recent_chooser_set_show_numbers    (GtkRecentChooser  *chooser,
-                                                         gboolean           show_numbers);
-gboolean          gtk_recent_chooser_get_show_numbers    (GtkRecentChooser  *chooser);
-#endif /* GTK_DISABLE_DEPRECATED */
 void              gtk_recent_chooser_set_show_icons      (GtkRecentChooser  *chooser,
                                                          gboolean           show_icons);
 gboolean          gtk_recent_chooser_get_show_icons      (GtkRecentChooser  *chooser);