[libzapojit] docs: Document zpj_skydrive_download_file_id_to_stream_async

[Debarshi Ray <debarshir src gnome org>]

commit 5bc35c67c7a222580c52dd754431522bffd0b561
Author: Debarshi Ray <debarshir gnome org>
Date:   Fri Jun 1 20:11:21 2012 +0200

    docs: Document zpj_skydrive_download_file_id_to_stream_async

 src/zpj-skydrive.c |   36 +++++++++++++++++++++++++++++++++++-
 1 files changed, 35 insertions(+), 1 deletions(-)
---
diff --git a/src/zpj-skydrive.c b/src/zpj-skydrive.c
index aca9b57..476b967 100644
--- a/src/zpj-skydrive.c
+++ b/src/zpj-skydrive.c
@@ -436,7 +436,9 @@ zpj_skydrive_delete_entry_id (ZpjSkydrive *self, const gchar *entry_id, GCancell
  * Synchronously returns a stream for downloading the file
  * corresponding to @file_id from
  * <ulink url="http://msdn.microsoft.com/en-us/library/live/hh826521";>
- * Skydrive</ulink>.
+ * Skydrive</ulink>. See
+ * zpj_skydrive_download_file_id_to_stream_async() for the asynchronous
+ * version of this call.
  *
  * Returns: (transfer full): A #GInputStream to read the file data
  * from. Free the returned object with g_object_unref().
@@ -491,6 +493,26 @@ zpj_skydrive_download_file_id_to_stream (ZpjSkydrive *self,
 }
 
 
+/**
+ * zpj_skydrive_download_file_id_to_stream_async:
+ * @self: A #ZpjSkydrive.
+ * @file_id: The ID of the #ZpjSkydriveFile to be downloaded.
+ * @cancellable: (allow-none): An optional #GCancellable object, or
+ *   %NULL.
+ * @callback: (scope async): A #GAsyncReadyCallback to call when the
+ *   request is satisfied.
+ * @user_data: (closure): The data to pass to @callback.
+ *
+ * Asynchronously returns a stream for downloading the file
+ * corresponding to @file_id from
+ * <ulink url="http://msdn.microsoft.com/en-us/library/live/hh826521";>
+ * Skydrive</ulink>. See zpj_skydrive_download_file_id_to_stream() for
+ * the synchronous version of this call.
+ *
+ * When the operation is finished, @callback will be called. You can
+ * then call zpj_skydrive_download_file_id_to_stream_finish() to get
+ * the result of the operation.
+ */
 void
 zpj_skydrive_download_file_id_to_stream_async (ZpjSkydrive *self,
                                                const gchar *file_id,
@@ -521,6 +543,18 @@ zpj_skydrive_download_file_id_to_stream_async (ZpjSkydrive *self,
 }
 
 
+/**
+ * zpj_skydrive_download_file_id_to_stream_finish:
+ * @self: A #ZpjSkydrive.
+ * @res: A #GAsyncResult.
+ * @error: (allow-none): An optional #GError, or %NULL.
+ *
+ * Finishes an asynchronous operation started with
+ * zpj_skydrive_download_file_id_to_stream_async().
+ *
+ * Returns: (transfer full): A #GInputStream to read the file data
+ * from. Free the returned object with g_object_unref().
+ */
 GInputStream *
 zpj_skydrive_download_file_id_to_stream_finish (ZpjSkydrive *self,
                                                 GAsyncResult *res,