diff options
author | Martyn Russell <martyn@lanedo.com> | 2010-09-30 15:35:14 +0100 |
---|---|---|
committer | Martyn Russell <martyn@lanedo.com> | 2010-09-30 15:39:37 +0100 |
commit | 23d3c91b6c1edd2e800cb0bc4ddec43ca918a983 (patch) | |
tree | 2d0b51f17cf5fee90293be979b91cc49b80be1ea | |
parent | ca5eecf778f4b52cf5df708af7c5a2e28d69a1bb (diff) | |
download | tracker-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.c | 4 | ||||
-rw-r--r-- | src/libtracker-extract/tracker-iptc.c | 4 | ||||
-rw-r--r-- | src/libtracker-extract/tracker-utils.c | 12 | ||||
-rw-r--r-- | src/libtracker-extract/tracker-xmp.c | 4 | ||||
-rw-r--r-- | src/libtracker-miner/tracker-miner-fs.c | 2 | ||||
-rw-r--r-- | src/libtracker-miner/tracker-network-provider.c | 2 | ||||
-rw-r--r-- | src/libtracker-miner/tracker-network-provider.h | 6 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-builder.vala | 64 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-connection.vala | 26 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-cursor.vala | 30 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-uri.c | 12 | ||||
-rw-r--r-- | 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 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 "<urn:file:1234-5678>". 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 (); |