libtracker-sparql: Sanitize "Since" tagswip/carlosg/batches-and-resources

Remove all pre-3.0 ones, and drop API indexes prior to that.

8 files changed, 6 insertions, 130 deletions

diff --git a/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml b/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml
index b22943d68..2599b0f5a 100644
--- a/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml
+++ b/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml
@@ -68,33 +68,13 @@
     <title>Index of deprecated symbols</title>
     <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
   </index>
-  <index id="api-index-0-10" role="0.10">
-    <title>Index of new symbols in 0.10</title>
-    <xi:include href="xml/api-index-0.10.xml"><xi:fallback /></xi:include>
+  <index id="api-index-3-0" role="3.0">
+    <title>Index of new symbols in 3.1</title>
+    <xi:include href="xml/api-index-3.0.xml"><xi:fallback /></xi:include>
   </index>
-  <index id="api-index-0-12" role="0.12">
-    <title>Index of new symbols in 0.12</title>
-    <xi:include href="xml/api-index-0.12.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-1-10" role="1.10">
-    <title>Index of new symbols in 1.10</title>
-    <xi:include href="xml/api-index-1.10.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-1-12" role="1.12">
-    <title>Index of new symbols in 1.12</title>
-    <xi:include href="xml/api-index-1.12.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-2-0" role="2.0">
-    <title>Index of new symbols in 2.0</title>
-    <xi:include href="xml/api-index-2.0.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-2-0-5" role="2.0.5">
-    <title>Index of new symbols in 2.0.5</title>
-    <xi:include href="xml/api-index-2.0.5.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-2-2" role="2.2">
-    <title>Index of new symbols in 2.2</title>
-    <xi:include href="xml/api-index-2.2.xml"><xi:fallback /></xi:include>
+  <index id="api-index-3-1" role="3.1">
+    <title>Index of new symbols in 3.1</title>
+    <xi:include href="xml/api-index-3.1.xml"><xi:fallback /></xi:include>
   </index>
 
   <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
diff --git a/src/libtracker-sparql/tracker-connection.c b/src/libtracker-sparql/tracker-connection.c
index 74cff7fc7..5dcc3d226 100644
--- a/src/libtracker-sparql/tracker-connection.c
+++ b/src/libtracker-sparql/tracker-connection.c
@@ -182,8 +182,6 @@ tracker_sparql_connection_class_init (TrackerSparqlConnectionClass *klass)
  *
  * Returns: (transfer full): a new remote #TrackerSparqlConnection. Call
  * g_object_unref() on the object when no longer used.
- *
- * Since: 1.12
  */
 
 /**
diff --git a/src/libtracker-sparql/tracker-namespace-manager.c b/src/libtracker-sparql/tracker-namespace-manager.c
index c4f4a3003..d8f284ca9 100644
--- a/src/libtracker-sparql/tracker-namespace-manager.c
+++ b/src/libtracker-sparql/tracker-namespace-manager.c
@@ -99,8 +99,6 @@ finalize (GObject *object)
  * Creates a new #TrackerNamespaceManager instance.
  *
  * Returns: a new #TrackerNamespaceManager instance
- *
- * Since: 1.10
  */
 TrackerNamespaceManager *
 tracker_namespace_manager_new ()
@@ -123,8 +121,6 @@ tracker_namespace_manager_new ()
  * ontologies, if they have been modified since they were installed.
  *
  * Returns: (transfer none): a global, shared #TrackerNamespaceManager instance
- *
- * Since: 1.10
  */
 TrackerNamespaceManager *
 tracker_namespace_manager_get_default ()
@@ -165,8 +161,6 @@ tracker_namespace_manager_get_default ()
  * Returns whether @prefix is known.
  *
  * Returns: %TRUE if the #TrackerNamespaceManager knows about @prefix, %FALSE otherwise
- *
- * Since: 1.10
  */
 gboolean
 tracker_namespace_manager_has_prefix (TrackerNamespaceManager *self,
@@ -190,8 +184,6 @@ tracker_namespace_manager_has_prefix (TrackerNamespaceManager *self,
  * is not known.
  *
  * Returns: a string owned by the #TrackerNamespaceManager, or %NULL
- *
- * Since: 1.10
  */
 const char *
 tracker_namespace_manager_lookup_prefix (TrackerNamespaceManager *self,
@@ -216,8 +208,6 @@ tracker_namespace_manager_lookup_prefix (TrackerNamespaceManager *self,
  *
  * Only one prefix is allowed for a given namespace, and all prefixes must
  * be unique.
- *
- * Since: 1.10
  */
 void
 tracker_namespace_manager_add_prefix (TrackerNamespaceManager *self,
@@ -264,8 +254,6 @@ tracker_namespace_manager_add_prefix (TrackerNamespaceManager *self,
  * expanded URI. Otherwise, a copy of @compact_uri will be returned.
  *
  * Returns: a newly-allocated string
- *
- * Since: 1.10
  */
 char *
 tracker_namespace_manager_expand_uri (TrackerNamespaceManager *self,
@@ -307,8 +295,6 @@ tracker_namespace_manager_expand_uri (TrackerNamespaceManager *self,
  * Writes out all namespaces as Turtle @prefix statements.
  *
  * Returns: a newly-allocated string
- *
- * Since: 1.10
  */
 char *
 tracker_namespace_manager_print_turtle (TrackerNamespaceManager *self)
@@ -338,8 +324,6 @@ tracker_namespace_manager_print_turtle (TrackerNamespaceManager *self)
  * @user_data: user data to pass to the function
  *
  * Calls @func for each known prefix / URI pair.
- *
- * Since: 1.10
  */
 void
 tracker_namespace_manager_foreach (TrackerNamespaceManager *self,
diff --git a/src/libtracker-sparql/tracker-notifier.c b/src/libtracker-sparql/tracker-notifier.c
index 38e6897fe..cf1c9a9dd 100644
--- a/src/libtracker-sparql/tracker-notifier.c
+++ b/src/libtracker-sparql/tracker-notifier.c
@@ -883,8 +883,6 @@ _tracker_notifier_get_connection (TrackerNotifier *notifier)
  * Returns the event type.
  *
  * Returns: The event type
- *
- * Since: 1.12
  **/
 TrackerNotifierEventType
 tracker_notifier_event_get_event_type (TrackerNotifierEvent *event)
@@ -901,8 +899,6 @@ tracker_notifier_event_get_event_type (TrackerNotifierEvent *event)
  * which is used as efficient internal identifier for the resource.
  *
  * Returns: the resource ID
- *
- * Since: 1.12
  **/
 gint64
 tracker_notifier_event_get_id (TrackerNotifierEvent *event)
@@ -922,8 +918,6 @@ tracker_notifier_event_get_id (TrackerNotifierEvent *event)
  * notified upon, typically of the form "urn:uuid:...".
  *
  * Returns: The element URN
- *
- * Since: 1.12
  **/
 const gchar *
 tracker_notifier_event_get_urn (TrackerNotifierEvent *event)
diff --git a/src/libtracker-sparql/tracker-resource.c b/src/libtracker-sparql/tracker-resource.c
index 480f0d9ed..5c64e24c5 100644
--- a/src/libtracker-sparql/tracker-resource.c
+++ b/src/libtracker-sparql/tracker-resource.c
@@ -227,8 +227,6 @@ set_property (GObject      *object,
  * Creates a TrackerResource instance.
  *
  * Returns: a newly created #TrackerResource. Free with g_object_unref() when done
- *
- * Since: 1.10
  */
 TrackerResource *
 tracker_resource_new (const char *identifier)
@@ -264,8 +262,6 @@ tracker_resource_new (const char *identifier)
  * You can pass any kind of GValue for @value, but serialization functions will
  * normally only be able to serialize URIs/relationships and fundamental value
  * types (string, int, etc.).
- *
- * Since: 1.10
  */
 void
 tracker_resource_set_gvalue (TrackerResource *self,
@@ -363,8 +359,6 @@ validate_pointer (const void *pointer,
  * @value: the property object
  *
  * Sets a single-valued boolean object.
- *
- * Since: 1.10
  */
 SET_PROPERTY_FOR_GTYPE (tracker_resource_set_boolean, gboolean, G_TYPE_BOOLEAN, g_value_set_boolean, validate_boolean);
 
@@ -375,8 +369,6 @@ SET_PROPERTY_FOR_GTYPE (tracker_resource_set_boolean, gboolean, G_TYPE_BOOLEAN,
  * @value: the property object
  *
  * Sets a single-valued double object.
- *
- * Since: 1.10
  */
 SET_PROPERTY_FOR_GTYPE (tracker_resource_set_double, double, G_TYPE_DOUBLE, g_value_set_double, validate_double);
 
@@ -387,8 +379,6 @@ SET_PROPERTY_FOR_GTYPE (tracker_resource_set_double, double, G_TYPE_DOUBLE, g_va
  * @value: the property object
  *
  * Sets a single-valued integer object.
- *
- * Since: 1.10
  */
 SET_PROPERTY_FOR_GTYPE (tracker_resource_set_int, int, G_TYPE_INT, g_value_set_int, validate_int);
 
@@ -399,8 +389,6 @@ SET_PROPERTY_FOR_GTYPE (tracker_resource_set_int, int, G_TYPE_INT, g_value_set_i
  * @value: the property object
  *
  * Sets a single-valued integer object.
- *
- * Since: 1.10
  */
 SET_PROPERTY_FOR_GTYPE (tracker_resource_set_int64, gint64, G_TYPE_INT64, g_value_set_int64, validate_int64);
 
@@ -414,8 +402,6 @@ SET_PROPERTY_FOR_GTYPE (tracker_resource_set_int64, gint64, G_TYPE_INT64, g_valu
  * function produces similar RDF to tracker_resource_set_uri(),
  * although in this function the URI will depend on the identifier
  * set on @resource.
- *
- * Since: 1.10
  */
 SET_PROPERTY_FOR_GTYPE (tracker_resource_set_relation, TrackerResource *, TRACKER_TYPE_RESOURCE, g_value_set_object, validate_pointer);
 
@@ -429,8 +415,6 @@ SET_PROPERTY_FOR_GTYPE (tracker_resource_set_relation, TrackerResource *, TRACKE
  * function produces similar RDF to tracker_resource_set_uri(),
  * although in this function the URI will depend on the identifier
  * set on @resource. This function takes ownership of @resource.
- *
- * Since: 2.0
  */
 SET_PROPERTY_FOR_GTYPE (tracker_resource_set_take_relation, TrackerResource *, TRACKER_TYPE_RESOURCE, g_value_take_object, validate_pointer);
 
@@ -441,8 +425,6 @@ SET_PROPERTY_FOR_GTYPE (tracker_resource_set_take_relation, TrackerResource *, T
  * @value: the property object
  *
  * Sets a single-valued string object.
- *
- * Since: 1.10
  */
 SET_PROPERTY_FOR_GTYPE (tracker_resource_set_string, const char *, G_TYPE_STRING, g_value_set_string, validate_pointer);
 
@@ -455,8 +437,6 @@ SET_PROPERTY_FOR_GTYPE (tracker_resource_set_string, const char *, G_TYPE_STRING
  * Sets a single-valued resource object as a string URI. This function
  * produces similar RDF to tracker_resource_set_relation(), although
  * it requires that the URI is previously known.
- *
- * Since: 1.10
  */
 SET_PROPERTY_FOR_GTYPE (tracker_resource_set_uri, const char *, TRACKER_TYPE_URI, g_value_set_string, validate_pointer);
 
@@ -471,8 +451,6 @@ SET_PROPERTY_FOR_GTYPE (tracker_resource_set_uri, const char *, TRACKER_TYPE_URI
  * You can pass any kind of GValue for @value, but serialization functions will
  * normally only be able to serialize URIs/relationships and fundamental value
  * types (string, int, etc.).
- *
- * Since: 1.10
  */
 void
 tracker_resource_add_gvalue (TrackerResource *self,
@@ -583,8 +561,6 @@ tracker_resource_add_gvalue (TrackerResource *self,
  * @value: the property object
  *
  * Adds a boolean object to a multi-valued property.
- *
- * Since: 1.10
  */
 ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_boolean, gboolean, G_TYPE_BOOLEAN, g_value_set_boolean, validate_boolean);
 
@@ -595,8 +571,6 @@ ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_boolean, gboolean, G_TYPE_BOOLEAN,
  * @value: the property object
  *
  * Adds a double object to a multi-valued property.
- *
- * Since: 1.10
  */
 ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_double, double, G_TYPE_DOUBLE, g_value_set_double, validate_double);
 
@@ -607,8 +581,6 @@ ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_double, double, G_TYPE_DOUBLE, g_va
  * @value: the property object
  *
  * Adds an integer object to a multi-valued property.
- *
- * Since: 1.10
  */
 ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_int, int, G_TYPE_INT, g_value_set_int, validate_int);
 
@@ -619,8 +591,6 @@ ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_int, int, G_TYPE_INT, g_value_set_i
  * @value: the property object
  *
  * Adds an integer object to a multi-valued property.
- *
- * Since: 1.10
  */
 ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_int64, gint64, G_TYPE_INT64, g_value_set_int64, validate_int64);
 
@@ -634,8 +604,6 @@ ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_int64, gint64, G_TYPE_INT64, g_valu
  * function produces similar RDF to tracker_resource_add_uri(),
  * although in this function the URI will depend on the identifier
  * set on @resource.
- *
- * Since: 1.10
  */
 ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_relation, TrackerResource *, TRACKER_TYPE_RESOURCE, g_value_set_object, validate_pointer);
 
@@ -649,8 +617,6 @@ ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_relation, TrackerResource *, TRACKE
  * function produces similar RDF to tracker_resource_add_uri(),
  * although in this function the URI will depend on the identifier
  * set on @resource. This function takes ownership of @resource.
- *
- * Since: 2.0
  */
 ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_take_relation, TrackerResource *, TRACKER_TYPE_RESOURCE, g_value_take_object, validate_pointer);
 
@@ -662,8 +628,6 @@ ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_take_relation, TrackerResource *, T
  * @value: the property object
  *
  * Adds a string object to a multi-valued property.
- *
- * Since: 1.10
  */
 ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_string, const char *, G_TYPE_STRING, g_value_set_string, validate_pointer);
 
@@ -676,8 +640,6 @@ ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_string, const char *, G_TYPE_STRING
  * Adds a resource object to a multi-valued property. This function
  * produces similar RDF to tracker_resource_add_relation(), although
  * it requires that the URI is previously known.
- *
- * Since: 1.10
  */
 ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_uri, const char *, TRACKER_TYPE_URI, g_value_set_string, validate_pointer);
 
@@ -691,8 +653,6 @@ ADD_PROPERTY_FOR_GTYPE (tracker_resource_add_uri, const char *, TRACKER_TYPE_URI
  *
  * Returns: (transfer container) (element-type GValue): a #GList of #GValue
  * instances. The list should be freed with g_list_free()
- *
- * Since: 1.10
  */
 GList *tracker_resource_get_values (TrackerResource *self,
                                     const char      *property_uri)
@@ -768,8 +728,6 @@ GList *tracker_resource_get_values (TrackerResource *self,
  * Returns the first boolean object previously assigned to a property.
  *
  * Returns: the first boolean object
- *
- * Since: 1.10
  */
 GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_boolean, gboolean, G_TYPE_BOOLEAN, g_value_get_boolean, FALSE);
 
@@ -781,8 +739,6 @@ GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_boolean, gboolean, G_TYPE_BOO
  * Returns the first double object previously assigned to a property.
  *
  * Returns: the first double object
- *
- * Since: 1.10
  */
 GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_double, double, G_TYPE_DOUBLE, g_value_get_double, 0.0);
 
@@ -794,8 +750,6 @@ GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_double, double, G_TYPE_DOUBLE
  * Returns the first integer object previously assigned to a property.
  *
  * Returns: the first integer object
- *
- * Since: 1.10
  */
 GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_int, int, G_TYPE_INT, g_value_get_int, 0);
 
@@ -807,8 +761,6 @@ GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_int, int, G_TYPE_INT, g_value
  * Returns the first integer object previously assigned to a property.
  *
  * Returns: the first integer object
- *
- * Since: 1.10
  */
 GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_int64, gint64, G_TYPE_INT64, g_value_get_int64, 0);
 
@@ -820,8 +772,6 @@ GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_int64, gint64, G_TYPE_INT64,
  * Returns the first resource object previously assigned to a property.
  *
  * Returns: (transfer none): the first resource object
- *
- * Since: 1.10
  */
 GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_relation, TrackerResource *, TRACKER_TYPE_RESOURCE, g_value_get_object, NULL);
 
@@ -833,8 +783,6 @@ GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_relation, TrackerResource *,
  * Returns the first string object previously assigned to a property.
  *
  * Returns: the first string object
- *
- * Since: 1.10
  */
 GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_string, const char *, G_TYPE_STRING, g_value_get_string, NULL);
 
@@ -846,8 +794,6 @@ GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_string, const char *, G_TYPE_
  * Returns the first resource object previously assigned to a property.
  *
  * Returns: the first resource object as an URI.
- *
- * Since: 1.10
  */
 GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_uri, const char *, TRACKER_TYPE_URI, g_value_get_string, NULL);
 
@@ -861,8 +807,6 @@ GET_PROPERTY_FOR_GTYPE (tracker_resource_get_first_uri, const char *, TRACKER_TY
  * SPARQL blank node identifier, such as "_:123".
  *
  * Returns: a string owned by the resource
- *
- * Since: 1.10
  */
 const char *
 tracker_resource_get_identifier (TrackerResource *self)
@@ -888,8 +832,6 @@ tracker_resource_get_identifier (TrackerResource *self)
  *
  * If the identifier is set to NULL, a SPARQL blank node identifier such as
  * "_:123" is assigned to the resource.
- *
- * Since: 1.10
  */
 void
 tracker_resource_set_identifier (TrackerResource *self,
@@ -953,8 +895,6 @@ tracker_resource_identifier_compare_func (TrackerResource *resource,
  * thing.
  *
  * Returns: 0 if the identifiers are the same, -1 or +1 otherwise
- *
- * Since: 1.10
  */
 gint
 tracker_resource_compare (TrackerResource *a,
@@ -1284,8 +1224,6 @@ generate_turtle (TrackerResource    *resource,
  * usual prefixes for all of the ontologies that Tracker ships with by default.
  *
  * Returns: a newly-allocated string
- *
- * Since: 1.10
  */
 char *
 tracker_resource_print_turtle (TrackerResource         *self,
@@ -1541,8 +1479,6 @@ generate_sparql_insert_pattern (TrackerResource    *resource,
  * usual prefixes for all of the ontologies that Tracker ships with by default.
  *
  * Returns: a newly-allocated string containing a SPARQL update command.
- *
- * Since: 1.10
  */
 char *
 tracker_resource_print_sparql_update (TrackerResource         *resource,
@@ -1731,8 +1667,6 @@ generate_jsonld_namespace_mapping_foreach (gpointer key,
  * usual prefixes for all of the ontologies that Tracker ships with by default.
  *
  * Returns: a newly-allocated string containing JSON-LD data.
- *
- * Since: 2.0.5
  */
 char *
 tracker_resource_print_jsonld (TrackerResource         *self,
@@ -1819,8 +1753,6 @@ tracker_serialize_single_value (TrackerResource         *resource,
  *
  * Returns: (transfer full): A variant describing the resource,
  *          the reference is floating.
- *
- * Since: 3.0
  **/
 GVariant *
 tracker_resource_serialize (TrackerResource *resource)
@@ -1898,8 +1830,6 @@ tracker_resource_serialize (TrackerResource *resource)
  *
  * Returns: (transfer full): A TrackerResource, or %NULL if
  *          deserialization fails.
- *
- * Since: 3.0
  **/
 TrackerResource *
 tracker_resource_deserialize (GVariant *variant)
diff --git a/src/libtracker-sparql/tracker-uri.c b/src/libtracker-sparql/tracker-uri.c
index b97f84527..3f01256b0 100644
--- a/src/libtracker-sparql/tracker-uri.c
+++ b/src/libtracker-sparql/tracker-uri.c
@@ -161,8 +161,6 @@ find_conversion (const char  *format,
  *
  * Returns: (transfer full): 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,
@@ -265,8 +263,6 @@ cleanup:
  *
  * Returns: (transfer full): 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, ...)
@@ -289,8 +285,6 @@ tracker_sparql_escape_uri_printf (const gchar *format, ...)
  *
  * Returns: (transfer full): a newly-allocated string holding the result. The returned string
  * should be freed with g_free() when no longer needed.
- *
- * Since: 1.12
  */
 gchar *
 tracker_sparql_escape_uri (const gchar *uri)
diff --git a/src/libtracker-sparql/tracker-version.c b/src/libtracker-sparql/tracker-version.c
index 6a71facab..7fd829482 100644
--- a/src/libtracker-sparql/tracker-version.c
+++ b/src/libtracker-sparql/tracker-version.c
@@ -66,8 +66,6 @@ const guint tracker_binary_age = TRACKER_BINARY_AGE;
  *   given version, or a string describing the version mismatch.
  *   The returned string is owned by Tracker and must not be modified
  *   or freed.
- *
- * Since: 0.10
  **/
 const gchar *
 tracker_check_version (guint required_major,
diff --git a/src/libtracker-sparql/tracker-version.h b/src/libtracker-sparql/tracker-version.h
index 5419cdfc0..cb730fbc9 100644
--- a/src/libtracker-sparql/tracker-version.h
+++ b/src/libtracker-sparql/tracker-version.h
@@ -135,8 +135,6 @@ GLIB_VAR const guint tracker_binary_age;
  * }
  * </programlisting>
  * </example>
- *
- * Since: 0.10
  **/
 #define TRACKER_CHECK_VERSION(major,minor,micro)    \
     (TRACKER_MAJOR_VERSION > (major) || \