[grilo] src: Expand documentation for GrlSourceResolveCb

[Philip Withnall <pwithnall src gnome org>]

commit 7d981c4f55b975db6aff0e592802d7cf0c1698a5
Author: Philip Withnall <philip withnall collabora co uk>
Date:   Mon May 4 09:17:47 2015 +0100

    src: Expand documentation for GrlSourceResolveCb
    
    https://bugzilla.gnome.org/show_bug.cgi?id=748873

 src/grl-source.h |    7 ++++++-
 1 files changed, 6 insertions(+), 1 deletions(-)
---
diff --git a/src/grl-source.h b/src/grl-source.h
index 7201f60..24163fd 100644
--- a/src/grl-source.h
+++ b/src/grl-source.h
@@ -135,7 +135,12 @@ typedef enum {
  * @user_data: user data passed to grl_source_resolve()
  * @error: (nullable): possible #GError generated at processing
  *
- * Prototype for the callback passed to grl_source_resolve()
+ * Prototype for the callback passed to grl_source_resolve(). If the URI did
+ * not resolve to a valid media record, @media will be %NULL. If there was an
+ * error during resolution, @error will be set.
+ *
+ * If @media is non-%NULL, ownership of it is transferred to the callback, and
+ * it must be freed afterwards using g_object_unref().
  */
 typedef void (*GrlSourceResolveCb) (GrlSource *source,
                                     guint operation_id,