[tracker/0.10-documentation-review: 11/11] libtracker-sparql: Builder API is all new in 0.10, as this is a new library

[Aleksander Morgado <aleksm src gnome org>]

commit bcc26c6b51cadb163cac34747248205b980fe479
Author: Aleksander Morgado <aleksander lanedo com>
Date:   Tue Feb 8 12:48:04 2011 +0100

    libtracker-sparql: Builder API is all new in 0.10, as this is a new library

 src/libtracker-sparql/tracker-builder.vala |   67 ++++++++++++++++------------
 1 files changed, 39 insertions(+), 28 deletions(-)
---
diff --git a/src/libtracker-sparql/tracker-builder.vala b/src/libtracker-sparql/tracker-builder.vala
index 07d1ad4..a7c3b68 100644
--- a/src/libtracker-sparql/tracker-builder.vala
+++ b/src/libtracker-sparql/tracker-builder.vala
@@ -52,6 +52,7 @@
  *
  * Returns: a newly created #TrackerSparqlBuilder. Free with g_object_unref() when done
  *
+ * Since: 0.10
  */
 public class Tracker.Sparql.Builder : Object {
 
@@ -92,13 +93,15 @@ public class Tracker.Sparql.Builder : Object {
 	 * Returns: the created SPARQL query. The string is contained in the
 	 * #TrackerSparqlBuilder object, and should not be freed by the caller.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 
 	/**
 	 * TrackerSparqlBuilder:result:
 	 *
 	 * String containing the constructed SPARQL in the #TrackerSparqlBuilder.
+	 *
+	 * Since: 0.10
 	 */
 	public string result {
 		get {
@@ -115,13 +118,15 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Returns: the number of objects contained.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 
 	/**
 	 * TrackerSparqlBuilder:length:
 	 *
 	 * Number of objects added to the #TrackerSparqlBuilder.
+	 *
+	 * Since: 0.10
 	 */
 	public int length {
 		get;
@@ -136,13 +141,15 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Returns: a #TrackerSparqlBuilderState defining the current state of @self
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 
 	/**
 	 * TrackerSparqlBuilder:state:
 	 *
 	 * Current state of the #TrackerSparqlBuilder.
+	 *
+	 * Since: 0.10
 	 */
 	public State state {
 		get { return states[states.length - 1]; }
@@ -188,7 +195,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a DROP GRAPH clause.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void drop_graph (string iri)
 		requires (state == State.UPDATE)
@@ -203,7 +210,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Opens an insertion statement.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void insert_open (string? graph)
 		requires (state == State.UPDATE)
@@ -240,7 +247,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Closes an insertion statement opened with tracker_sparql_builder_insert_open().
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void insert_close ()
 		requires (state == State.INSERT || state == State.OBJECT)
@@ -264,7 +271,7 @@ 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
+	 * Since: 0.10
 	 */
 	public void delete_open (string? graph)
 		requires (state == State.UPDATE)
@@ -282,7 +289,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Closes a DELETE clause opened through tracker_sparql_builder_delete_open().
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void delete_close ()
 		requires (state == State.DELETE || state == State.OBJECT)
@@ -302,6 +309,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @graph: graph name.
 	 *
 	 * Opens a GRAPH clause within INSERT, DELETE, or WHERE.
+	 *
+	 * Since: 0.10
 	 */
 	public void graph_open (string graph)
 		requires (state == State.INSERT || state == State.DELETE || state == State.OBJECT || state == State.WHERE || state == State.GRAPH)
@@ -315,6 +324,8 @@ public class Tracker.Sparql.Builder : Object {
 	 * @self: a #TrackerSparqlBuilder
 	 *
 	 * Closes a GRAPH clause opened through tracker_sparql_builder_graph_open().
+	 *
+	 * Since: 0.10
 	 */
 	public void graph_close ()
 		requires (state == State.GRAPH || state == State.OBJECT)
@@ -335,7 +346,7 @@ 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
+	 * Since: 0.10
 	 */
 	public void where_open ()
 	       requires (state == State.UPDATE)
@@ -350,7 +361,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Closes a WHERE clause opened through tracker_sparql_builder_where_open().
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void where_close ()
 		requires (state == State.WHERE || state == State.OBJECT)
@@ -370,7 +381,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a subject as a SPARQL variable, such as "?urn".
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void subject_variable (string var_name) {
 		subject ("?%s".printf (var_name));
@@ -383,7 +394,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends an object as a SparQL variable, such as "?urn".
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void object_variable (string var_name) {
 		object ("?%s".printf (var_name));
@@ -397,7 +408,7 @@ 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
+	 * Since: 0.10
 	 */
 	public void subject_iri (string iri) {
 		subject ("<%s>".printf (iri));
@@ -410,7 +421,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a subject.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void subject (string s)
 		requires (state == State.INSERT || state == State.OBJECT || state == State.EMBEDDED_INSERT || state == State.DELETE || state == State.WHERE || state == State.GRAPH)
@@ -430,7 +441,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a predicate as an IRI.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void predicate_iri (string iri) {
 		predicate ("<%s>".printf (iri));
@@ -443,7 +454,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a predicate for the previously appended subject.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void predicate (string s)
 		requires (state == State.SUBJECT || state == State.OBJECT || state == State.BLANK)
@@ -464,7 +475,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends an object as an IRI.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void object_iri (string iri) {
 		object ("<%s>".printf (iri));
@@ -477,7 +488,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a free-form object for the previously appended subject and predicate.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void object (string s)
 		requires (state == State.PREDICATE || state == State.OBJECT)
@@ -501,7 +512,7 @@ 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
+	 * Since: 0.10
 	 */
 	public void object_string (string literal)
 		requires (state == State.PREDICATE || state == State.OBJECT)
@@ -554,7 +565,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a string not validated as UTF-8 as an object.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void object_unvalidated (string value) {
 		char* end;
@@ -579,7 +590,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a #gboolean value as an object.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void object_boolean (bool literal) {
 		object (literal ? "true" : "false");
@@ -592,7 +603,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a #gint64 value as an object.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void object_int64 (int64 literal) {
 		object (literal.to_string ());
@@ -606,7 +617,7 @@ 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
+	 * Since: 0.10
 	 */
 	public void object_date (ref time_t literal) {
 		var tm = Time.gm (literal);
@@ -621,7 +632,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends a #gdouble value as an object.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void object_double (double literal) {
 		object (literal.to_string ());
@@ -635,7 +646,7 @@ public class Tracker.Sparql.Builder : Object {
 	 * anonymous nodes for not previously known data without the need of a
 	 * separate insertion.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void object_blank_open ()
 		requires (state == State.PREDICATE || state == State.OBJECT)
@@ -654,7 +665,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Closes an anomymous blank node opened with tracker_sparql_builder_object_blank_open()
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void object_blank_close ()
 		requires (state == State.OBJECT && states[states.length - 3] == state.BLANK)
@@ -673,7 +684,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Prepends raw, unvalidated content to @self.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void prepend (string raw)
 	{
@@ -687,7 +698,7 @@ public class Tracker.Sparql.Builder : Object {
 	 *
 	 * Appends raw, unvalidated content to @self.
 	 *
-	 * Since: 0.8
+	 * Since: 0.10
 	 */
 	public void append (string raw)
 	{