[tracker: 4/4] Tweak documentation of tracker_decorator_info_get_task()



commit 05cfc97b121aaa45b07dc3c94ea40ff1fd35bbde
Author: Sam Thursfield <sam afuera me uk>
Date:   Fri Jun 10 23:59:33 2016 +0100

    Tweak documentation of tracker_decorator_info_get_task()
    
    Mention what the task's data will be. Readers might not realise that
    the documentation of tracker_decorator_info_get_sparql() holds that
    information (I didn't).

 src/libtracker-miner/tracker-decorator.c |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
---
diff --git a/src/libtracker-miner/tracker-decorator.c b/src/libtracker-miner/tracker-decorator.c
index 8f161d0..55f5f71 100644
--- a/src/libtracker-miner/tracker-decorator.c
+++ b/src/libtracker-miner/tracker-decorator.c
@@ -1754,6 +1754,11 @@ tracker_decorator_info_get_mimetype (TrackerDecoratorInfo *info)
  * Get the #GTask associated with retrieving extended metadata and
  * information for a URN in Tracker.
  *
+ * The task object's data (accessible with g_task_get_task_data()) is the
+ * #TrackerSparqlBuilder that you must populate with the results of the
+ * metadata extraction. This can also be accessed with
+ * tracker_decorator_info_get_sparql().
+ *
  * Returns: (transfer none): the #GTask for #TrackerDecoratorInfo on
  * success or #NULL if there is no existing #GTask.
  *


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]