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

gio/gmemoryinputstream.c

@@ -21,15 +21,23 @@
  */
 
 #include <config.h>
-
 #include "gmemoryinputstream.h"
 #include "ginputstream.h"
 #include "gseekable.h"
 #include "string.h"
 #include "gsimpleasyncresult.h"
-
 #include "glibintl.h"
 
+/**
+ * SECTION:gmemoryinputstream
+ * @short_description: streaming input operations on memory chunks
+ * @see_also: #GMemoryOutputStream.
+ *
+ * #GMemoryInputStream is a class for using arbitrary
+ * memory chunks as input for GIO streaming input operations.
+ *
+ */
+
 struct _GMemoryInputStreamPrivate {
   guint8 *buffer;      
   gsize   pos;