X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkrecentchooser.h;h=ae222c6de2a4c2fc181102f349967ef65e78e7a5;hb=9d0febc9a64a5bfb0fcfc3a88de4757f6c1ff090;hp=a30b78f69eef7fe91f36fdeca4643eb36030dd87;hpb=eff99c282cb6967f4b1df2f2b53f2bbb034ce79a;p=~andy%2Fgtk

diff --git a/gtk/gtkrecentchooser.h b/gtk/gtkrecentchooser.h
index a30b78f69..ae222c6de 100644
--- 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,12 +14,10 @@
  * 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)
+#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
 #error "Only <gtk/gtk.h> can be included directly."
 #endif
 
@@ -27,9 +25,8 @@
 #define __GTK_RECENT_CHOOSER_H__
 
 #include <gtk/gtkwidget.h>
-
-#include "gtkrecentmanager.h"
-#include "gtkrecentfilter.h"
+#include <gtk/gtkrecentmanager.h>
+#include <gtk/gtkrecentfilter.h>
 
 G_BEGIN_DECLS
 
@@ -51,7 +48,9 @@ G_BEGIN_DECLS
  *
  * 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);