[tracker/wip/carlosg/tracker-3.0-api-breaks: 8/79] libtracker-sparql: Drop TrackerSparqlBuilder

[Carlos Garnacho <carlosg src gnome org>]

commit c4efe0a85de6ecdb0adc8141ff5ba2204578a034
Author: Carlos Garnacho <carlosg gnome org>
Date:   Sun Aug 18 13:14:55 2019 +0200

    libtracker-sparql: Drop TrackerSparqlBuilder
    
    It's been deprecated time ago, now is a good time to remove it.

 docs/reference/libtracker-sparql/examples.xml      |  29 -
 .../libtracker-sparql/examples/builder-example.c   |  41 --
 .../libtracker-sparql/examples/meson.build         |   7 -
 .../libtracker-sparql/libtracker-sparql-docs.xml   |   1 -
 .../libtracker-sparql-sections.txt                 |  57 --
 docs/reference/libtracker-sparql/meson.build       |   2 +-
 src/libtracker-sparql-backend/tracker-sparql-2.map |   1 -
 src/libtracker-sparql/meson.build                  |   1 -
 src/libtracker-sparql/tracker-builder.vala         | 733 ---------------------
 src/libtracker-sparql/tracker-connection.vala      |   6 +-
 10 files changed, 4 insertions(+), 874 deletions(-)
---
diff --git a/docs/reference/libtracker-sparql/examples.xml b/docs/reference/libtracker-sparql/examples.xml
index 2f0a07885..4703dd284 100644
--- a/docs/reference/libtracker-sparql/examples.xml
+++ b/docs/reference/libtracker-sparql/examples.xml
@@ -12,35 +12,6 @@
     </para>
   </partintro>
 
-
-  <chapter id="tracker-examples-builder">
-    <title>SPARQL query builder</title>
-
-    <para>
-      The Tracker SPARQL library provides an easy and secure way of creating
-      SPARQL queries with the proper syntax. This is achieved using the
-      <type><link linkend="TrackerSparqlBuilder-struct">TrackerSparqlBuilder</link></type>
-      object.
-    </para>
-
-    <para>
-    <informalexample>
-      <programlisting language="C">
-        <xi:include href="builder-example.c" parse="text"/>
-      </programlisting>
-    </informalexample>
-
-      The previous code will generate the following SPARQL query:
-<programlisting>
-DROP GRAPH &lt;urn:example:0001&gt;
-INSERT INTO &lt;urn:example:0001&gt; {
-  &lt;urn:example:0001&gt; a nie:DataObject , nfo:FileDataObject ;
-                     nfo:fileLastModified "2010-08-04T13:09:26Z" .
-}
-</programlisting>
-    </para>
-  </chapter>
-
   <chapter id="tracker-examples-readonly">
     <title>Querying the Store</title>
 
diff --git a/docs/reference/libtracker-sparql/examples/meson.build 
b/docs/reference/libtracker-sparql/examples/meson.build
index 8b2ba17a0..1cb1d9f3f 100644
--- a/docs/reference/libtracker-sparql/examples/meson.build
+++ b/docs/reference/libtracker-sparql/examples/meson.build
@@ -1,10 +1,3 @@
-executable(
-  'builder-example',
-  'builder-example.c',
-  dependencies: tracker_sparql_dep,
-  build_by_default: true
-)
-
 executable(
   'readonly-example',
   'readonly-example.c',
diff --git a/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml 
b/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml
index e599974cd..78f6d3b8a 100644
--- a/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml
+++ b/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml
@@ -31,7 +31,6 @@
 
     <xi:include href="xml/tracker-resource.xml"/>
     <xi:include href="xml/tracker-namespace-manager.xml"/>
-    <xi:include href="xml/tracker-sparql-builder.xml"/>
     <xi:include href="xml/tracker-sparql-connection.xml"/>
     <xi:include href="xml/tracker-sparql-statement.xml"/>
     <xi:include href="xml/tracker-sparql-cursor.xml"/>
diff --git a/docs/reference/libtracker-sparql/libtracker-sparql-sections.txt 
b/docs/reference/libtracker-sparql/libtracker-sparql-sections.txt
index 3dee48c12..08bddd7c0 100644
--- a/docs/reference/libtracker-sparql/libtracker-sparql-sections.txt
+++ b/docs/reference/libtracker-sparql/libtracker-sparql-sections.txt
@@ -97,63 +97,6 @@ TrackerNamespaceManagerClass
 TRACKER_TYPE_NAMESPACE_MANAGER
 </SECTION>
 
-<SECTION>
-<FILE>tracker-sparql-builder</FILE>
-<TITLE>TrackerSparqlBuilder</TITLE>
-TrackerSparqlBuilder
-TrackerSparqlBuilderState
-tracker_sparql_builder_new
-tracker_sparql_builder_new_embedded_insert
-tracker_sparql_builder_new_update
-tracker_sparql_builder_get_state
-tracker_sparql_builder_get_result
-tracker_sparql_builder_get_length
-tracker_sparql_builder_append
-tracker_sparql_builder_prepend
-tracker_sparql_builder_insert_open
-tracker_sparql_builder_insert_silent_open
-tracker_sparql_builder_insert_close
-tracker_sparql_builder_where_open
-tracker_sparql_builder_where_close
-tracker_sparql_builder_delete_open
-tracker_sparql_builder_delete_close
-tracker_sparql_builder_graph_open
-tracker_sparql_builder_graph_close
-tracker_sparql_builder_subject_variable
-tracker_sparql_builder_subject_iri
-tracker_sparql_builder_subject
-tracker_sparql_builder_predicate_iri
-tracker_sparql_builder_predicate
-tracker_sparql_builder_object_iri
-tracker_sparql_builder_object
-tracker_sparql_builder_object_string
-tracker_sparql_builder_object_boolean
-tracker_sparql_builder_object_int64
-tracker_sparql_builder_object_date
-tracker_sparql_builder_object_double
-tracker_sparql_builder_object_variable
-tracker_sparql_builder_object_blank_open
-tracker_sparql_builder_object_blank_close
-tracker_sparql_builder_object_unvalidated
-<SUBSECTION Standard>
-TrackerSparqlBuilderClass
-TRACKER_SPARQL_BUILDER
-TRACKER_SPARQL_IS_BUILDER
-TRACKER_SPARQL_TYPE_BUILDER
-tracker_sparql_builder_get_type
-TRACKER_SPARQL_BUILDER_CLASS
-TRACKER_SPARQL_IS_BUILDER_CLASS
-TRACKER_SPARQL_BUILDER_GET_CLASS
-TRACKER_SPARQL_BUILDER_TYPE_STATE
-tracker_sparql_builder_state_get_type
-<SUBSECTION Private>
-TrackerSparqlBuilderPrivate
-tracker_sparql_builder_construct
-tracker_sparql_builder_construct_embedded_insert
-tracker_sparql_builder_construct_update
-</SECTION>
-
-
 <SECTION>
 <FILE>tracker-sparql-connection</FILE>
 <TITLE>TrackerSparqlConnection</TITLE>
diff --git a/docs/reference/libtracker-sparql/meson.build b/docs/reference/libtracker-sparql/meson.build
index b09b1207e..505bdabcc 100644
--- a/docs/reference/libtracker-sparql/meson.build
+++ b/docs/reference/libtracker-sparql/meson.build
@@ -23,7 +23,7 @@ example_files = [
     'examples/ontologies/defining-properties-3.txt', 'examples/ontologies/defining-properties-4.rq',
     'examples/ontologies/defining-uniqueness-1.txt', 'examples/ontologies/defining-uniqueness-2.rq',
     'examples/ontologies/example.description', 'examples/ontologies/predefined-elements-1.txt',
-    'examples/ontologies/predefined-elements-2.rq', 'examples/builder-example.c',
+    'examples/ontologies/predefined-elements-2.rq',
     'examples/readonly-example.c', 'examples/writeonly-example.c',
     'examples/writeonly-with-blank-nodes-example.c',
 ]
diff --git a/src/libtracker-sparql-backend/tracker-sparql-2.map 
b/src/libtracker-sparql-backend/tracker-sparql-2.map
index 336778ae2..deb119152 100644
--- a/src/libtracker-sparql-backend/tracker-sparql-2.map
+++ b/src/libtracker-sparql-backend/tracker-sparql-2.map
@@ -2,7 +2,6 @@
 global:
   tracker_sparql_connection_*;
   tracker_sparql_cursor_*;
-  tracker_sparql_builder_*;
   tracker_sparql_escape_*;
   tracker_sparql_error_*;
   tracker_sparql_value_*;
diff --git a/src/libtracker-sparql/meson.build b/src/libtracker-sparql/meson.build
index 971d39bf3..51d89d196 100644
--- a/src/libtracker-sparql/meson.build
+++ b/src/libtracker-sparql/meson.build
@@ -13,7 +13,6 @@ libtracker_sparql_c_vapi_dep = meson.get_compiler('vala').find_library('libtrack
 
 libtracker_sparql_intermediate_vala = static_library('tracker-sparql-intermediate-vala',
     'tracker-namespace.vala',
-    'tracker-builder.vala',
     'tracker-connection.vala',
     'tracker-cursor.vala',
     'tracker-statement.vala',
diff --git a/src/libtracker-sparql/tracker-connection.vala b/src/libtracker-sparql/tracker-connection.vala
index 95c9d546c..b94517468 100644
--- a/src/libtracker-sparql/tracker-connection.vala
+++ b/src/libtracker-sparql/tracker-connection.vala
@@ -244,7 +244,7 @@ public abstract class Tracker.Sparql.Connection : Object {
         * Executes a SPARQL query on. The API call is completely synchronous, so
         * it may block.
         *
-        * The @sparql query should be built with #TrackerSparqlBuilder, or
+        * The @sparql query should be built with #TrackerResource, or
         * its parts correctly escaped using tracker_sparql_escape_string(),
         * otherwise SPARQL injection is possible.
         *
@@ -297,7 +297,7 @@ public abstract class Tracker.Sparql.Connection : Object {
         * Executes a SPARQL update. The API call is completely
         * synchronous, so it may block.
         *
-        * The @sparql query should be built with #TrackerSparqlBuilder, or
+        * The @sparql query should be built with #TrackerResource, or
         * its parts correctly escaped using tracker_sparql_escape_string(),
         * otherwise SPARQL injection is possible.
         *
@@ -413,7 +413,7 @@ public abstract class Tracker.Sparql.Connection : Object {
         * Executes a SPARQL update and returns the URNs of the generated nodes,
         * if any. The API call is completely synchronous, so it may block.
         *
-        * The @sparql query should be built with #TrackerSparqlBuilder, or
+        * The @sparql query should be built with #TrackerResource, or
         * its parts correctly escaped using tracker_sparql_escape_string(),
         * otherwise SPARQL injection is possible.
         *