summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMartyn Russell <martyn@lanedo.com>2010-09-30 15:35:14 +0100
committerMartyn Russell <martyn@lanedo.com>2010-09-30 15:39:37 +0100
commit23d3c91b6c1edd2e800cb0bc4ddec43ca918a983 (patch)
tree2d0b51f17cf5fee90293be979b91cc49b80be1ea
parentca5eecf778f4b52cf5df708af7c5a2e28d69a1bb (diff)
downloadtracker-23d3c91b6c1edd2e800cb0bc4ddec43ca918a983.tar.gz
libtracker-extract, libtracker-miner, libtracker-sparql: Added Since: tags to docs
Also changed all 0.9 cases to 0.10
-rw-r--r--src/libtracker-extract/tracker-exif.c4
-rw-r--r--src/libtracker-extract/tracker-iptc.c4
-rw-r--r--src/libtracker-extract/tracker-utils.c12
-rw-r--r--src/libtracker-extract/tracker-xmp.c4
-rw-r--r--src/libtracker-miner/tracker-miner-fs.c2
-rw-r--r--src/libtracker-miner/tracker-network-provider.c2
-rw-r--r--src/libtracker-miner/tracker-network-provider.h6
-rw-r--r--src/libtracker-sparql/tracker-builder.vala64
-rw-r--r--src/libtracker-sparql/tracker-connection.vala26
-rw-r--r--src/libtracker-sparql/tracker-cursor.vala30
-rw-r--r--src/libtracker-sparql/tracker-uri.c12
-rw-r--r--src/libtracker-sparql/tracker-utils.vala4
12 files changed, 146 insertions, 24 deletions
diff --git a/src/libtracker-extract/tracker-exif.c b/src/libtracker-extract/tracker-exif.c
index 203b94da4..0374ff01e 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 8fb186603..03d852b60 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 98d553335..0f8091c59 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 bd7012d64..229ba9d52 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 e9c0fe28a..08c42b958 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 501262157..244600eac 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 ac48822d9..0dcedd103 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 76384bf30..f9cc3018f 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 4430d57e1..e3bb0fed6 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 4311143cd..439e52161 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 ac84dc6f9..d5dca7cd1 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 bdad65822..78fbd39c1 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 ();