[tracker/rss-enclosures] libtracker-extract, libtracker-miner, libtracker-sparql: Added Since: tags to docs

From: Roberto Guido <rguido src gnome org>
To: commits-list gnome org
Cc:
Subject: [tracker/rss-enclosures] libtracker-extract, libtracker-miner, libtracker-sparql: Added Since: tags to docs
Date: Wed, 24 Nov 2010 01:55:07 +0000 (UTC)
commit 6acbcc27ade544ef5acfad1303603c04f8dcccb4
Author: Martyn Russell <martyn lanedo com>
Date:   Thu Sep 30 15:35:14 2010 +0100

    libtracker-extract, libtracker-miner, libtracker-sparql: Added Since: tags to docs
    
    Also changed all 0.9 cases to 0.10

 src/libtracker-extract/tracker-exif.c           |    4 +-
 src/libtracker-extract/tracker-iptc.c           |    4 +-
 src/libtracker-extract/tracker-utils.c          |   12 ++--
 src/libtracker-extract/tracker-xmp.c            |    4 +-
 src/libtracker-miner/tracker-miner-fs.c         |    2 +-
 src/libtracker-miner/tracker-network-provider.c |    2 +-
 src/libtracker-miner/tracker-network-provider.h |    6 +-
 src/libtracker-sparql/tracker-builder.vala      |   64 ++++++++++++++++++++++-
 src/libtracker-sparql/tracker-connection.vala   |   26 +++++++++
 src/libtracker-sparql/tracker-cursor.vala       |   30 ++++++++++-
 src/libtracker-sparql/tracker-uri.c             |   12 +++--
 src/libtracker-sparql/tracker-utils.vala        |    4 +-
 12 files changed, 146 insertions(+), 24 deletions(-)
---
diff --git a/src/libtracker-extract/tracker-exif.c b/src/libtracker-extract/tracker-exif.c
index 203b94d..0374ff0 100644
--- a/src/libtracker-extract/tracker-exif.c
+++ b/src/libtracker-extract/tracker-exif.c
@@ -455,7 +455,7 @@ tracker_exif_read (const unsigned char *buffer,
  * Returns: a newly allocated #TrackerExifData struct if EXIF data was
  * found, %NULL otherwise. Free the returned struct with tracker_exif_free().
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 TrackerExifData *
 tracker_exif_new (const guchar *buffer,
@@ -485,7 +485,7 @@ tracker_exif_new (const guchar *buffer,
  * Frees @data and all #TrackerExifData members. %NULL will produce a
  * a warning.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 void
 tracker_exif_free (TrackerExifData *data)
diff --git a/src/libtracker-extract/tracker-iptc.c b/src/libtracker-extract/tracker-iptc.c
index 8fb1866..03d852b 100644
--- a/src/libtracker-extract/tracker-iptc.c
+++ b/src/libtracker-extract/tracker-iptc.c
@@ -268,7 +268,7 @@ tracker_iptc_read (const unsigned char *buffer,
  * found, %NULL otherwise. Free the returned struct with
  * tracker_iptc_free().
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 TrackerIptcData *
 tracker_iptc_new (const guchar *buffer,
@@ -298,7 +298,7 @@ tracker_iptc_new (const guchar *buffer,
  * Frees @data and all #TrackerIptcData members. %NULL will produce a
  * a warning.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 void
 tracker_iptc_free (TrackerIptcData *data)
diff --git a/src/libtracker-extract/tracker-utils.c b/src/libtracker-extract/tracker-utils.c
index 98d5533..0f8091c 100644
--- a/src/libtracker-extract/tracker-utils.c
+++ b/src/libtracker-extract/tracker-utils.c
@@ -89,7 +89,7 @@ static const char imonths[] = {
  * Returns: the first string pointer from those provided which
  * matches, otherwise %NULL.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 const gchar *
 tracker_coalesce_strip (gint n_values,
@@ -180,7 +180,7 @@ tracker_coalesce (gint n_values,
  * Returns: a newly-allocated string holding the result which should
  * be freed with g_free() when finished with, otherwise %NULL.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 gchar *
 tracker_merge_const (const gchar *delimiter,
@@ -371,7 +371,7 @@ tracker_text_normalize (const gchar *text,
  *
  * Returns: %TRUE if some bytes were found to be valid, %FALSE otherwise.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 gboolean
 tracker_text_validate_utf8 (const gchar  *text,
@@ -907,7 +907,7 @@ my_igetdelim (gchar  **linebuf,
  * can be used to handle embedded %NULL bytes in the line read. Upon
  * failure, -1 is returned.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 gssize
 tracker_getline (gchar **lineptr,
@@ -936,7 +936,7 @@ tracker_getline (gchar **lineptr,
  * can be used to handle embedded %NULL bytes in the line read. Upon
  * failure, -1 is returned.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 gssize
 tracker_getline (gchar **lineptr,
@@ -957,7 +957,7 @@ tracker_getline (gchar **lineptr,
  * Parses a keywords line into store, avoiding duplicates and stripping leading
  * and trailing spaces from keywords. Allowed delimiters are , and ;
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 void
 tracker_keywords_parse (GPtrArray   *store,
diff --git a/src/libtracker-extract/tracker-xmp.c b/src/libtracker-extract/tracker-xmp.c
index bd7012d..229ba9d 100644
--- a/src/libtracker-extract/tracker-xmp.c
+++ b/src/libtracker-extract/tracker-xmp.c
@@ -562,7 +562,7 @@ tracker_xmp_read (const gchar    *buffer,
  * Returns: a newly allocated #TrackerXmpData struct if XMP data was
  * found, %NULL otherwise. Free the returned struct with tracker_xmp_free().
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 TrackerXmpData *
 tracker_xmp_new (const gchar *buffer,
@@ -592,7 +592,7 @@ tracker_xmp_new (const gchar *buffer,
  * Frees @data and all #TrackerXmpData members. %NULL will produce a
  * a warning.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 void
 tracker_xmp_free (TrackerXmpData *data)
diff --git a/src/libtracker-miner/tracker-miner-fs.c b/src/libtracker-miner/tracker-miner-fs.c
index e9c0fe2..08c42b9 100644
--- a/src/libtracker-miner/tracker-miner-fs.c
+++ b/src/libtracker-miner/tracker-miner-fs.c
@@ -4018,7 +4018,7 @@ tracker_miner_fs_get_urn (TrackerMinerFS *fs,
  * Returns: A newly allocated string with the URN containing the data associated
  *          to @file, or %NULL.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 gchar *
 tracker_miner_fs_query_urn (TrackerMinerFS *fs,
diff --git a/src/libtracker-miner/tracker-network-provider.c b/src/libtracker-miner/tracker-network-provider.c
index 5012621..244600e 100644
--- a/src/libtracker-miner/tracker-network-provider.c
+++ b/src/libtracker-miner/tracker-network-provider.c
@@ -34,7 +34,7 @@
  * the network as connected, no matter what the connectivity status actually
  * is.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 
 static void
diff --git a/src/libtracker-miner/tracker-network-provider.h b/src/libtracker-miner/tracker-network-provider.h
index ac48822..0dcedd1 100644
--- a/src/libtracker-miner/tracker-network-provider.h
+++ b/src/libtracker-miner/tracker-network-provider.h
@@ -51,7 +51,7 @@ typedef struct TrackerNetworkProvider TrackerNetworkProvider;
  * @TRACKER_NETWORK_PROVIDER_LAN: Network is connected over a local network
  * connection. This can be ethernet, wifi, etc.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 typedef enum {
 	TRACKER_NETWORK_PROVIDER_DISCONNECTED,
@@ -67,7 +67,7 @@ typedef enum {
  * @parent_iface: parent object interface
  * @get_status: get the network status
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 typedef struct {
 	GTypeInterface parent_iface;
@@ -94,7 +94,7 @@ TrackerNetworkProviderStatus
  *
  * Returns: a %TrackerNetworkProvider.
  *
- * Since: 0.9
+ * Since: 0.10
  **/
 TrackerNetworkProvider *
         tracker_network_provider_get        (void);
diff --git a/src/libtracker-sparql/tracker-builder.vala b/src/libtracker-sparql/tracker-builder.vala
index 76384bf..f9cc301 100644
--- a/src/libtracker-sparql/tracker-builder.vala
+++ b/src/libtracker-sparql/tracker-builder.vala
@@ -94,7 +94,9 @@ public class Tracker.Sparql.Builder : Object {
 		 * Returns the constructed SPARQL query as a string.
 		 *
 		 * Returns: the created SPARQL query. The string is contained in the
-		 *  #TrackerSparqlBuilder object, and should not be freed by the caller.
+		 * #TrackerSparqlBuilder object, and should not be freed by the caller.
+		 *
+		 * Since: 0.8
 		 */
 		get {
 			warn_if_fail (states.length == 1);
@@ -115,6 +117,8 @@ public class Tracker.Sparql.Builder : Object {
 		 * Returns the number of objects added to @self.
 		 *
 		 * Returns: the number of objects contained.
+		 *
+		 * Since: 0.8
 		 */
 		get;
 		private set;
@@ -133,6 +137,8 @@ public class Tracker.Sparql.Builder : Object {
 		 * Returns the current state of @self
 		 *
 		 * Returns: a #TrackerSparqlBuilderState defining the current state of @self
+		 *
+		 * Since: 0.8
 		 */
 		get { return states[states.length - 1]; }
 	}
@@ -146,6 +152,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * Creates an empty #TrackerSparqlBuilder for an update query.
 	 *
 	 * Returns: a newly created #TrackerSparqlBuilder. Free with g_object_unref() when done
+	 *
+	 * Since: 0.10
 	 */
 	public Builder.update () {
 		states += State.UPDATE;
@@ -159,6 +167,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * append predicates and objects for the given subject are allowed.
 	 *
 	 * Returns: a newly created #TrackerSparqlBuilder. Free with g_object_unref() when done
+	 *
+	 * Since: 0.10
 	 */
 	public Builder.embedded_insert () {
 		states += State.EMBEDDED_INSERT;
@@ -172,6 +182,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @iri: a graph name.
 	 *
 	 * Appends a DROP GRAPH clause.
+	 *
+	 * Since: 0.8
 	 */
 	public void drop_graph (string iri)
 		requires (state == State.UPDATE)
@@ -185,6 +197,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @graph: graph name, or %NULL.
 	 *
 	 * Opens an insertion statement.
+	 *
+	 * Since: 0.8
 	 */
 	public void insert_open (string? graph)
 		requires (state == State.UPDATE)
@@ -202,6 +216,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @graph: graph name, or %NULL.
 	 *
 	 * Opens a silent insertion statement.
+	 *
+	 * Since: 0.10
 	 */
 	public void insert_silent_open (string? graph)
 		requires (state == State.UPDATE)
@@ -218,6 +234,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @self: a #TrackerSparqlBuilder
 	 *
 	 * Closes an insertion statement opened with tracker_sparql_builder_insert_open().
+	 *
+	 * Since: 0.8
 	 */
 	public void insert_close ()
 		requires (state == State.INSERT || state == State.OBJECT)
@@ -240,6 +258,8 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Opens a DELETE clause. Data triples may be appended in order to prepare
 	 * a query to delete them.
+	 *
+	 * Since: 0.8
 	 */
 	public void delete_open (string? graph)
 		requires (state == State.UPDATE)
@@ -256,6 +276,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @self: a #TrackerSparqlBuilder
 	 *
 	 * Closes a DELETE clause opened through tracker_sparql_builder_delete_open().
+	 *
+	 * Since: 0.8
 	 */
 	public void delete_close ()
 		requires (state == State.DELETE || state == State.OBJECT)
@@ -275,6 +297,8 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Opens a WHERE clause. Data triples may be appended then to narrow the scope
 	 * to which the update query applies.
+	 *
+	 * Since: 0.8
 	 */
 	public void where_open ()
 	       requires (state == State.UPDATE)
@@ -288,6 +312,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @self: a #TrackerSparqlBuilder
 	 *
 	 * Closes a WHERE clause opened through tracker_sparql_builder_where_open().
+	 *
+	 * Since: 0.8
 	 */
 	public void where_close ()
 		requires (state == State.WHERE || state == State.OBJECT)
@@ -306,6 +332,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @var_name: variable name, without leading '?'
 	 *
 	 * Appends a subject as a SPARQL variable, such as "?urn".
+	 *
+	 * Since: 0.8
 	 */
 	public void subject_variable (string var_name) {
 		subject ("?%s".printf (var_name));
@@ -317,6 +345,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @var_name: variable name, without leading '?'
 	 *
 	 * Appends an object as a SparQL variable, such as "?urn".
+	 *
+	 * Since: 0.8
 	 */
 	public void object_variable (string var_name) {
 		object ("?%s".printf (var_name));
@@ -329,6 +359,8 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a subject as an IRI, such as "&lt;urn:file:1234-5678&gt;". IRIs
 	 * univocally identify a resource in tracker-store.
+	 *
+	 * Since: 0.8
 	 */
 	public void subject_iri (string iri) {
 		subject ("<%s>".printf (iri));
@@ -340,6 +372,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @s: subject string
 	 *
 	 * Appends a subject.
+	 *
+	 * Since: 0.8
 	 */
 	public void subject (string s)
 		requires (state == State.INSERT || state == State.OBJECT || state == State.EMBEDDED_INSERT || state == State.DELETE || state == State.WHERE)
@@ -358,6 +392,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @iri: IRI name, without leading and trailing greater/less than symbols.
 	 *
 	 * Appends a predicate as an IRI.
+	 *
+	 * Since: 0.8
 	 */
 	public void predicate_iri (string iri) {
 		predicate ("<%s>".printf (iri));
@@ -369,6 +405,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @s: predicate string
 	 *
 	 * Appends a predicate for the previously appended subject.
+	 *
+	 * Since: 0.8
 	 */
 	public void predicate (string s)
 		requires (state == State.SUBJECT || state == State.OBJECT || state == State.BLANK)
@@ -388,6 +426,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @iri: IRI name, without leading and trailing greater/less than symbols.
 	 *
 	 * Appends an object as an IRI.
+	 *
+	 * Since: 0.8
 	 */
 	public void object_iri (string iri) {
 		object ("<%s>".printf (iri));
@@ -399,6 +439,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @s: object string
 	 *
 	 * Appends a free-form object for the previously appended subject and predicate.
+	 *
+	 * Since: 0.8
 	 */
 	public void object (string s)
 		requires (state == State.PREDICATE || state == State.OBJECT)
@@ -421,6 +463,8 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends an object formatted as an string. @literal will be escaped and surrounded
 	 * by double quotes.
+	 *
+	 * Since: 0.8
 	 */
 	public void object_string (string literal)
 		requires (state == State.PREDICATE || state == State.OBJECT)
@@ -472,6 +516,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @value: possibly UTF-8 invalid string.
 	 *
 	 * Appends a string not validated as UTF-8 as an object.
+	 *
+	 * Since: 0.8
 	 */
 	public void object_unvalidated (string value) {
 		char* end;
@@ -495,6 +541,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @literal: object as a #gboolean
 	 *
 	 * Appends a #gboolean value as an object.
+	 *
+	 * Since: 0.8
 	 */
 	public void object_boolean (bool literal) {
 		object (literal ? "true" : "false");
@@ -506,6 +554,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @literal: object as a #gint64
 	 *
 	 * Appends a #gint64 value as an object.
+	 *
+	 * Since: 0.8
 	 */
 	public void object_int64 (int64 literal) {
 		object (literal.to_string ());
@@ -518,6 +568,8 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a #time_t value as an object. @literal will be converted
 	 * to a string in the date format used by tracker-store.
+	 *
+	 * Since: 0.8
 	 */
 	public void object_date (ref time_t literal) {
 		var tm = Time.gm (literal);
@@ -531,6 +583,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @literal: object as a #gdouble
 	 *
 	 * Appends a #gdouble value as an object.
+	 *
+	 * Since: 0.8
 	 */
 	public void object_double (double literal) {
 		object (literal.to_string ());
@@ -543,6 +597,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * Opens an anonymous blank node. In insertions this can be used to create
 	 * anonymous nodes for not previously known data without the need of a
 	 * separate insertion.
+	 *
+	 * Since: 0.8
 	 */
 	public void object_blank_open ()
 		requires (state == State.PREDICATE || state == State.OBJECT)
@@ -560,6 +616,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @self: a #TrackerSparqlBuilder
 	 *
 	 * Closes an anomymous blank node opened with tracker_sparql_builder_object_blank_open()
+	 *
+	 * Since: 0.8
 	 */
 	public void object_blank_close ()
 		requires (state == State.OBJECT && states[states.length - 3] == state.BLANK)
@@ -577,6 +635,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @raw: raw content to prepend.
 	 *
 	 * Prepends raw, unvalidated content to @self.
+	 *
+	 * Since: 0.8
 	 */
 	public void prepend (string raw)
 	{
@@ -589,6 +649,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @raw: raw content to append.
 	 *
 	 * Appends raw, unvalidated content to @self.
+	 *
+	 * Since: 0.8
 	 */
 	public void append (string raw)
 	{
diff --git a/src/libtracker-sparql/tracker-connection.vala b/src/libtracker-sparql/tracker-connection.vala
index 4430d57..e3bb0fe 100644
--- a/src/libtracker-sparql/tracker-connection.vala
+++ b/src/libtracker-sparql/tracker-connection.vala
@@ -353,6 +353,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 * @cancellable: a #GCancellable used to cancel the operation
 	 *
 	 * Executes asynchronously a SPARQL query on the store.
+	 *
+	 * Since: 0.10
 	 */
 
 	/**
@@ -381,6 +383,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 *
 	 * Executes a SPARQL update on the store. The API call is completely
 	 * synchronous, so it may block.
+	 *
+	 * Since: 0.10
 	 */
 	public virtual void update (string sparql, int priority = GLib.Priority.DEFAULT, Cancellable? cancellable = null) throws Sparql.Error, IOError {
 		warning ("Interface 'update' not implemented");
@@ -397,6 +401,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 * @cancellable: a #GCancellable used to cancel the operation
 	 *
 	 * Executes asynchronously a SPARQL update on the store.
+	 *
+	 * Since: 0.10
 	 */
 
 	/**
@@ -406,6 +412,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 * @error: #GError for error reporting.
 	 *
 	 * Finishes the asynchronous SPARQL update operation.
+	 *
+	 * Since: 0.10
 	 */
 	public async virtual void update_async (string sparql, int priority = GLib.Priority.DEFAULT, Cancellable? cancellable = null) throws Sparql.Error, IOError {
 		warning ("Interface 'update_async' not implemented");
@@ -425,6 +433,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 *
 	 * Returns: a #GVariant with the generated URNs, which should be freed with
 	 * g_variant_unref() when no longer used.
+	 *
+	 * Since: 0.10
 	 */
 	public virtual GLib.Variant? update_blank (string sparql, int priority = GLib.Priority.DEFAULT, Cancellable? cancellable = null) throws Sparql.Error, IOError {
 		warning ("Interface 'update_blank' not implemented");
@@ -442,6 +452,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 * @cancellable: a #GCancellable used to cancel the operation
 	 *
 	 * Executes asynchronously a SPARQL update on the store.
+	 *
+	 * Since: 0.10
 	 */
 
 	/**
@@ -455,6 +467,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 *
 	 * Returns: a #GVariant with the generated URNs, which should be freed with
 	 * g_variant_unref() when no longer used.
+	 *
+	 * Since: 0.10
 	 */
 	public async virtual GLib.Variant? update_blank_async (string sparql, int priority = GLib.Priority.DEFAULT, Cancellable? cancellable = null) throws Sparql.Error, IOError {
 		warning ("Interface 'update_blank_async' not implemented");
@@ -470,6 +484,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 *
 	 * Loads a Turtle file (TTL) into the store. The API call is completely
 	 * synchronous, so it may block.
+	 *
+	 * Since: 0.10
 	 */
 	public virtual void load (File file, Cancellable? cancellable = null) throws Sparql.Error, IOError {
 		warning ("Interface 'load' not implemented");
@@ -485,6 +501,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 * @cancellable: a #GCancellable used to cancel the operation
 	 *
 	 * Loads, asynchronously, a Turtle file (TTL) into the store.
+	 *
+	 * Since: 0.10
 	 */
 
 	/**
@@ -494,6 +512,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 * @error: #GError for error reporting.
 	 *
 	 * Finishes the asynchronous load of the Turtle file.
+	 *
+	 * Since: 0.10
 	 */
 	public async virtual void load_async (File file, Cancellable? cancellable = null) throws Sparql.Error, IOError {
 		warning ("Interface 'load_async' not implemented");
@@ -511,6 +531,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 * Returns: a #TrackerSparqlCursor to iterate the reply if successful, #NULL
 	 * on error. Call g_object_unref() on the returned cursor when no longer
 	 * needed.
+	 *
+	 * Since: 0.10
 	 */
 	public virtual Cursor? statistics (Cancellable? cancellable = null) throws Sparql.Error, IOError {
 		warning ("Interface 'statistics' not implemented");
@@ -526,6 +548,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 * @cancellable: a #GCancellable used to cancel the operation
 	 *
 	 * Retrieves, asynchronously, the statistics from the Store.
+	 *
+	 * Since: 0.10
 	 */
 
 	/**
@@ -539,6 +563,8 @@ public abstract class Tracker.Sparql.Connection : Object {
 	 * Returns: a #TrackerSparqlCursor to iterate the reply if successful, #NULL
 	 * on error. Call g_object_unref() on the returned cursor when no longer
 	 * needed.
+	 *
+	 * Since: 0.10
 	 */
 	public async virtual Cursor? statistics_async (Cancellable? cancellable = null) throws Sparql.Error, IOError {
 		warning ("Interface 'statistics_async' not implemented");
diff --git a/src/libtracker-sparql/tracker-cursor.vala b/src/libtracker-sparql/tracker-cursor.vala
index 4311143..439e521 100644
--- a/src/libtracker-sparql/tracker-cursor.vala
+++ b/src/libtracker-sparql/tracker-cursor.vala
@@ -42,6 +42,8 @@
  * @TRACKER_SPARQL_VALUE_TYPE_BOOLEAN: Boolean value type, xsd:boolean
  *
  * Enumeration with the possible types of the cursor's cells
+ *
+ * Since: 0.10
  */
 public enum Tracker.Sparql.ValueType {
 	UNBOUND,
@@ -76,10 +78,12 @@ public abstract class Tracker.Sparql.Cursor : Object {
 		 *
 		 * Returns: a #TrackerSparqlConnection. The returned object must not
 		 * be freed by the caller.
+		 *
+		 * Since: 0.10
 		 */
 		get;
 		// Note: set method hidden in the documentation as the user of the
-		//  library should never use it.
+		// library should never use it.
 		set;
 	}
 
@@ -99,6 +103,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 		 * undefined.
 		 *
 		 * Returns: a #gint with the number of columns.
+		 *
+		 * Since: 0.10
 		 */
 		get;
 	}
@@ -111,6 +117,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 * Returns the value type at @column in the current row being iterated.
 	 *
 	 * Returns: a value type
+	 *
+	 * Since: 0.10
 	 */
 	public abstract ValueType get_value_type (int column);
 
@@ -122,6 +130,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 * Returns the variable name at @column.
 	 *
 	 * Returns: a string, which should not be freed by the caller.
+	 *
+	 * Since: 0.10
 	 */
 	public abstract unowned string? get_variable_name (int column);
 
@@ -135,6 +145,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 *
 	 * Returns: a string, which should not be freed by the caller. #NULL
 	 * is returned if the column number is in the [0,#n_columns] range.
+	 *
+	 * Since: 0.10
 	 */
 	public abstract unowned string? get_string (int column, out long length = null);
 
@@ -148,6 +160,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 * it may block.
 	 *
 	 * Returns: #FALSE if no more results found, #TRUE otherwise.
+	 *
+	 * Since: 0.10
 	 */
 	public abstract bool next (Cancellable? cancellable = null) throws GLib.Error;
 
@@ -160,6 +174,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 * @cancellable: a #GCancellable used to cancel the operation
 	 *
 	 * Iterates, asynchronously, to the next result.
+	 *
+	 * Since: 0.10
 	 */
 
 	/**
@@ -171,6 +187,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 * Finishes the asynchronous iteration to the next result.
 	 *
 	 * Returns: #FALSE if no more results found, #TRUE otherwise.
+	 *
+	 * Since: 0.10
 	 */
 	public async abstract bool next_async (Cancellable? cancellable = null) throws GLib.Error;
 
@@ -179,6 +197,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 * @self: a #TrackerSparqlCursor
 	 *
 	 * Resets the iterator to point back to the first result.
+	 *
+	 * Since: 0.10
 	 */
 	public abstract void rewind ();
 
@@ -191,6 +211,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 * Returns the integer at @column in the current row being iterated.
 	 *
 	 * Returns: a integer.
+	 *
+	 * Since: 0.10
 	 */
 	public virtual int64 get_integer (int column) {
 		return_val_if_fail (get_value_type (column) == ValueType.INTEGER, 0);
@@ -206,6 +228,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 * Returns the double at @column in the current row being iterated.
 	 *
 	 * Returns: a double.
+	 *
+	 * Since: 0.10
 	 */
 	public virtual double get_double (int column) {
 		return_val_if_fail (get_value_type (column) == ValueType.DOUBLE, 0);
@@ -221,6 +245,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 * Returns the boolean at @column in the current row being iterated.
 	 *
 	 * Returns: a boolean.
+	 *
+	 * Since: 0.10
 	 */
 	public virtual bool get_boolean (int column) {
 		ValueType type = get_value_type (column);
@@ -237,6 +263,8 @@ public abstract class Tracker.Sparql.Cursor : Object {
 	 * Returns true when @column at the current row being iterated is unbound
 	 *
 	 * Returns: a boolean.
+	 *
+	 * Since: 0.10
 	 */
 	public virtual bool is_bound (int column) {
 		if (get_value_type (column) != ValueType.UNBOUND) {
diff --git a/src/libtracker-sparql/tracker-uri.c b/src/libtracker-sparql/tracker-uri.c
index ac84dc6..d5dca7c 100644
--- a/src/libtracker-sparql/tracker-uri.c
+++ b/src/libtracker-sparql/tracker-uri.c
@@ -137,8 +137,10 @@ find_conversion (const char  *format,
  *
  * The result is escaped using g_uri_escape_string().
  *
- * Returns: a newly-allocated string holding the result.
- *  The returned string should be freed with g_free() when no longer needed.
+ * Returns: a newly-allocated string holding the result. The returned string
+ * should be freed with g_free() when no longer needed.
+ *
+ * Since: 0.10
  */
 gchar *
 tracker_sparql_escape_uri_vprintf (const gchar *format,
@@ -239,8 +241,10 @@ cleanup:
  *
  * Calls tracker_sparql_escape_uri_vprintf() with the @Varargs supplied.
  *
- * Returns: a newly-allocated string holding the result.
- *  The returned string should be freed with g_free() when no longer needed.
+ * Returns: a newly-allocated string holding the result.The returned string
+ * should be freed with g_free() when no longer needed.
+ *
+ * Since: 0.10
  */
 gchar *
 tracker_sparql_escape_uri_printf (const gchar *format, ...)
diff --git a/src/libtracker-sparql/tracker-utils.vala b/src/libtracker-sparql/tracker-utils.vala
index bdad658..78fbd39 100644
--- a/src/libtracker-sparql/tracker-utils.vala
+++ b/src/libtracker-sparql/tracker-utils.vala
@@ -41,7 +41,9 @@ namespace Tracker.Sparql {
 	 * Escapes a string so that it can be used in a SPARQL query.
 	 *
 	 * Returns: a newly-allocated string with the escaped version of @literal.
-	 *  The returned string should be freed with g_free() when no longer needed.
+	 * The returned string should be freed with g_free() when no longer needed.
+	 *
+	 * Since: 0.10
 	 */
 	public string escape_string (string literal) {
 		StringBuilder str = new StringBuilder ();
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]