summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCarlos Garnacho <carlosg@gnome.org>2021-05-28 01:45:37 +0200
committerCarlos Garnacho <carlosg@gnome.org>2021-06-04 15:52:25 +0200
commit10691a5d2e5a418e21e2e43212e9b8baa17a5214 (patch)
tree1fbf1c5dd1ea0c7ccee28d10eb3ff386a5f9f7ae
parentce8c16421c7dc27de25c32da27ef2076b4cb6038 (diff)
downloadtracker-10691a5d2e5a418e21e2e43212e9b8baa17a5214.tar.gz
docs: Drop "migrating 1.x to 2.x" docs
If there's anything left to be ported, perhaps it's time to admit some docs won't help it.
-rw-r--r--docs/reference/libtracker-sparql/migrating-1to2.xml57
1 files changed, 0 insertions, 57 deletions
diff --git a/docs/reference/libtracker-sparql/migrating-1to2.xml b/docs/reference/libtracker-sparql/migrating-1to2.xml
deleted file mode 100644
index 677b9a468..000000000
--- a/docs/reference/libtracker-sparql/migrating-1to2.xml
+++ /dev/null
@@ -1,57 +0,0 @@
-<?xml version='1.0'?>
-
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
- "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
-]>
-<chapter id="tracker-migrating-1-to-2">
- <title>Migrating from libtracker-sparql 1.x to 2.0</title>
-
- <para>
- Tracker 2.0 is a new major version, containing some possibly
- incompatible changes. Most of the changes are not hard to adapt,
- and even unlikely to be a problem if the ported application was
- kept up-to-date in its usage of 1.x.
- </para>
-
- <section>
- <title>Stricter SPARQL1.1</title>
- <para>
- Tracker supports a large subset of the SPARQL1.1 definition,
- and offers a number of nonstandard features that are useful.
- There is however one nonstandard feature that brings no
- added value.
- </para>
- <programlisting>
-# These were equivalent in Tracker 1.x
-SELECT ?u AS ?foo WHERE { ?u ... }
-SELECT ?u AS foo WHERE { ?u ... }
- </programlisting>
- <para>
- The latter form is not observed in the SPARQL1.1 spec, and
- support for it has been dropped in Tracker 2.0. If you want
- to make queries that work on both Tracker 2.0 and 1.x, use
- the former form, which has also been supported for a long
- time in 1.x.
- </para>
- </section>
-
- <section>
- <title>No getters for direct/bus SPARQL connections</title>
- <para>
- Those have been deprecated for a long time in 1.x and have
- been removed for 2.0. Use tracker_sparql_connection_get(),
- which will smartly use direct/bus connections underneath
- depending on the type of query.
- </para>
- </section>
-
- <section>
- <title>TrackerSparqlBuilder is deprecated</title>
- <para>
- Users are encouraged to use TrackerResource, included in
- the last 1.x releases, and now being the preferred method
- to create SPARQL updates for your data.
- </para>
- </section>
-</chapter>