diff options
author | Carlos Garnacho <carlosg@gnome.org> | 2020-11-22 02:21:42 +0100 |
---|---|---|
committer | Carlos Garnacho <carlosg@gnome.org> | 2020-11-27 00:14:06 +0100 |
commit | abbb813542d7e9f906232f2f35e299b43d65703a (patch) | |
tree | 30dd0d3b75c03faf39626ba7a457dca7e1218541 | |
parent | cb98b481a0c6ac38c16fc0da716cadeadd777f89 (diff) | |
download | tracker-wip/carlosg/batches-and-resources.tar.gz |
libtracker-sparql: Sanitize "Since" tagswip/carlosg/batches-and-resources
Remove all pre-3.0 ones, and drop API indexes prior to that.
-rw-r--r-- | docs/reference/libtracker-sparql/libtracker-sparql-docs.xml | 32 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-connection.c | 2 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-namespace-manager.c | 16 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-notifier.c | 6 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-resource.c | 70 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-uri.c | 6 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-version.c | 2 | ||||
-rw-r--r-- | src/libtracker-sparql/tracker-version.h | 2 |
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) || \ |