Fix docs

svn path=/trunk/; revision=7934

gio/ChangeLog

@@ -1,3 +1,7 @@
+2009-03-01  Matthias Clasen  <mclasen@redhat.com>
+
+	* gdatainputstream.c: Fix docs
+
 2009-02-27  Matthias Clasen  <mclasen@redhat.com>
 
 	Bug 573421 – Clarify message format in GMountOperation

gio/gdatainputstream.c

@@ -743,9 +743,9 @@ scan_for_newline (GDataInputStream *stream,
  * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
  *
  * Returns: a string with the line that was read in (without the newlines).
- * Set @length to a #gsize to get the length of the read line.
+ *     Set @length to a #gsize to get the length of the read line.
- * On an error, it will return %NULL and @error will be set. If there's no
+ *     On an error, it will return %NULL and @error will be set. If there's no
- * content to read, it will still return %NULL, but @error won't be set.
+ *     content to read, it will still return %NULL, but @error won't be set.
  **/
 char *
 g_data_input_stream_read_line (GDataInputStream  *stream,
@@ -864,9 +864,9 @@ scan_for_chars (GDataInputStream *stream,
  * occurrence of any of the stop characters.
  *
  * Returns: a string with the data that was read before encountering
- * any of the stop characters. Set @length to a #gsize to get the length 
+ *     any of the stop characters. Set @length to a #gsize to get the length
- * of the string. This function will return %NULL on an error.
+ *     of the string. This function will return %NULL on an error.
- **/
+ */
 char *
 g_data_input_stream_read_until (GDataInputStream  *stream,
 			       const gchar        *stop_chars,
@@ -1123,7 +1123,7 @@ g_data_input_stream_read_finish (GDataInputStream  *stream,
  * g_data_input_stream_read_line_async:
  * @stream: a given #GDataInputStream.
  * @io_priority: the <link linkend="io-priority">I/O priority</link>
- * of the request. 
+ *     of the request.
  * @cancellable: optional #GCancellable object, %NULL to ignore.
  * @callback: callback to call when the request is satisfied.
  * @user_data: the data to pass to callback function.
@@ -1131,6 +1131,10 @@ g_data_input_stream_read_finish (GDataInputStream  *stream,
  * The asynchronous version of g_data_input_stream_read_line().  It is
  * an error to have two outstanding calls to this function.
  *
+ * When the operation is finished, @callback will be called. You
+ * can then call g_data_input_stream_read_line_finish() to get
+ * the result of the operation.
+ *
  * Since: 2.20
  */
 void
@@ -1153,7 +1157,7 @@ g_data_input_stream_read_line_async (GDataInputStream    *stream,
  * @stream: a given #GDataInputStream.
  * @stop_chars: characters to terminate the read.
  * @io_priority: the <link linkend="io-priority">I/O priority</link>
- * of the request. 
+ *     of the request.
  * @cancellable: optional #GCancellable object, %NULL to ignore.
  * @callback: callback to call when the request is satisfied.
  * @user_data: the data to pass to callback function.
@@ -1161,6 +1165,10 @@ g_data_input_stream_read_line_async (GDataInputStream    *stream,
  * The asynchronous version of g_data_input_stream_read_until().
  * It is an error to have two outstanding calls to this function.
  *
+ * When the operation is finished, @callback will be called. You
+ * can then call g_data_input_stream_read_until_finish() to get
+ * the result of the operation.
+ *
  * Since: 2.20
  */
 void
@@ -1190,6 +1198,11 @@ g_data_input_stream_read_until_async (GDataInputStream    *stream,
  * Finish an asynchronous call started by
  * g_data_input_stream_read_line_async().
  *
+ * Returns: a string with the line that was read in (without the newlines).
+ *     Set @length to a #gsize to get the length of the read line.
+ *     On an error, it will return %NULL and @error will be set. If there's no
+ *     content to read, it will still return %NULL, but @error won't be set.
+ *
  * Since: 2,20
  */
 gchar *
@@ -1216,6 +1229,10 @@ g_data_input_stream_read_line_finish (GDataInputStream  *stream,
  * g_data_input_stream_read_until_async().
  *
  * Since: 2.20
+ *
+ * Returns: a string with the data that was read before encountering
+ *     any of the stop characters. Set @length to a #gsize to get the length
+ *     of the string. This function will return %NULL on an error.
  */
 gchar *
 g_data_input_stream_read_until_finish (GDataInputStream  *stream,
@@ -1230,5 +1247,6 @@ g_data_input_stream_read_until_finish (GDataInputStream  *stream,
   return g_data_input_stream_read_finish (stream, result, length, error);
 }
 
+
 #define __G_DATA_INPUT_STREAM_C__
 #include "gioaliasdef.c"