Bumps documentation to 93% symbol coverage, touching most

	of the public files. Fixes broken function documentation prototypes. 
	Fixes GCancellable inaccuracies. Removes unnecessary incomplete 
	gtk-doc headers in private files.

svn path=/trunk/; revision=5953

1 files changed, 7 insertions, 1 deletions

diff --git a/gio/gcancellable.h b/gio/gcancellable.h
index a6229da4f..be8495f6c 100644
--- a/gio/gcancellable.h
+++ b/gio/gcancellable.h
@@ -34,6 +34,11 @@ G_BEGIN_DECLS
 #define G_IS_CANCELLABLE_CLASS(k)  (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_CANCELLABLE))
 #define G_CANCELLABLE_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_CANCELLABLE, GCancellableClass))
 
+/**
+ * GCancellable:
+ * 
+ * Allows actions to be cancelled.
+ */
 typedef struct _GCancellable        GCancellable;
 typedef struct _GCancellableClass   GCancellableClass;
 
@@ -42,7 +47,8 @@ struct _GCancellableClass
   GObjectClass parent_class;
 
   void (* cancelled) (GCancellable *cancellable);
-
+  
+  /*< private >*/
   /* Padding for future expansion */
   void (*_g_reserved1) (void);
   void (*_g_reserved2) (void);