[tracker/wip/tintou/tracker-sparql-doc] docs: Modernize the libtracker-sparql documentation
- From: Corentin Noël <corentinnoel src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [tracker/wip/tintou/tracker-sparql-doc] docs: Modernize the libtracker-sparql documentation
- Date: Thu, 28 Mar 2019 16:23:47 +0000 (UTC)
commit 9279bf73e50b34821eecb41cd355c6a2f3cf63ba
Author: Corentin Noël <corentin elementary io>
Date: Thu Mar 28 17:22:48 2019 +0100
docs: Modernize the libtracker-sparql documentation
Still not fixed the Tracker 2.0 references here and there
.../{examples.sgml => examples.xml} | 0
.../libtracker-sparql/libtracker-sparql-docs.sgml | 57 -------------
.../libtracker-sparql/libtracker-sparql-docs.xml | 95 ++++++++++++++++++++++
.../libtracker-sparql-sections.txt | 42 +++++++++-
.../libtracker-sparql/libtracker-sparql.types | 8 --
docs/reference/libtracker-sparql/meson.build | 5 +-
.../{ontologies.sgml => ontologies.xml} | 0
.../{overview.sgml => overview.xml} | 0
src/libtracker-sparql/tracker-connection.vala | 10 +--
9 files changed, 141 insertions(+), 76 deletions(-)
---
diff --git a/docs/reference/libtracker-sparql/examples.sgml b/docs/reference/libtracker-sparql/examples.xml
similarity index 100%
rename from docs/reference/libtracker-sparql/examples.sgml
rename to docs/reference/libtracker-sparql/examples.xml
diff --git a/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml
b/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml
new file mode 100644
index 000000000..5f5611e18
--- /dev/null
+++ b/docs/reference/libtracker-sparql/libtracker-sparql-docs.xml
@@ -0,0 +1,95 @@
+<?xml version="1.0"?>
+<!DOCTYPE book 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'">
+<!ENTITY version SYSTEM "version.xml">
+]>
+<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
+ <bookinfo>
+ <title>Tracker SPARQL Library Reference Manual</title>
+ <releaseinfo>
+ for libtracker-sparql &version;.
+ The latest version of this documentation can be found on-line at
+ <ulink role="online-location" url="https://developer.gnome.org/libtracker-sparql/stable/">
+ https://developer.gnome.org/libtracker-sparql/stable
+ </ulink>.
+ </releaseinfo>
+ </bookinfo>
+
+ <!-- The Library Overview -->
+ <xi:include href="overview.xml"/>
+
+ <!-- The API Reference -->
+ <part id="libtracker-sparql-reference">
+ <title>Reference</title>
+ <partintro>
+ <para>
+ This section provides the detailed API of the Tracker SPARQL library.
+ </para>
+ </partintro>
+
+ <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"/>
+ <xi:include href="xml/tracker-notifier.xml"/>
+ <xi:include href="xml/tracker-misc.xml"/>
+ <xi:include href="xml/tracker-version.xml"/>
+ </part>
+
+ <part id="base-ontology">
+ <title>Base ontology</title>
+ <xi:include href="xml/dc-ontology.xml"/>
+ <xi:include href="xml/xsd-ontology.xml"/>
+ <xi:include href="xml/rdf-ontology.xml"/>
+ <xi:include href="xml/nrl-ontology.xml"/>
+ <xi:include href="xml/nao-ontology.xml"/>
+ </part>
+
+ <xi:include href="ontologies.xml"/>
+ <xi:include href="private-store.xml"/>
+ <xi:include href="examples.xml"/>
+ <xi:include href="migrating-1to2.xml"/>
+
+ <index id="api-index-full">
+ <title>Index</title>
+ <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
+ </index>
+ <index id="api-index-deprecated" role="deprecated">
+ <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>
+ <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>
+
+ <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
+</book>
diff --git a/docs/reference/libtracker-sparql/libtracker-sparql-sections.txt
b/docs/reference/libtracker-sparql/libtracker-sparql-sections.txt
index 5f7899a10..8c0b6a4ef 100644
--- a/docs/reference/libtracker-sparql/libtracker-sparql-sections.txt
+++ b/docs/reference/libtracker-sparql/libtracker-sparql-sections.txt
@@ -7,6 +7,9 @@ tracker_sparql_escape_string
tracker_sparql_escape_uri
tracker_sparql_escape_uri_printf
tracker_sparql_escape_uri_vprintf
+<SUBSECTION Standard>
+TRACKER_TYPE_URI
+tracker_uri_get_type
</SECTION>
<SECTION>
@@ -45,6 +48,27 @@ tracker_resource_get_values
tracker_resource_identifier_compare_func
tracker_resource_print_sparql_update
tracker_resource_print_turtle
+tracker_resource_print_jsonld
+TRACKER_DATASOURCE_URN_NON_REMOVABLE_MEDIA
+TRACKER_OWN_GRAPH_URN
+TRACKER_PREFIX_DATASOURCE_URN
+TRACKER_PREFIX_DC
+TRACKER_PREFIX_MFO
+TRACKER_PREFIX_MLO
+TRACKER_PREFIX_NAO
+TRACKER_PREFIX_NCO
+TRACKER_PREFIX_NFO
+TRACKER_PREFIX_NID3
+TRACKER_PREFIX_NIE
+TRACKER_PREFIX_NMM
+TRACKER_PREFIX_NMO
+TRACKER_PREFIX_NRL
+TRACKER_PREFIX_OSINFO
+TRACKER_PREFIX_RDF
+TRACKER_PREFIX_RDFS
+TRACKER_PREFIX_SLO
+TRACKER_PREFIX_TRACKER
+TRACKER_PREFIX_XSD
<SUBSECTION Standard>
TrackerResourceClass
TRACKER_RESOURCE
@@ -59,6 +83,7 @@ TRACKER_RESOURCE_GET_CLASS
<SECTION>
<FILE>tracker-namespace-manager</FILE>
<TITLE>TrackerNamespaceManager</TITLE>
+TrackerNamespaceManager
tracker_namespace_manager_add_prefix
tracker_namespace_manager_expand_uri
tracker_namespace_manager_get_default
@@ -66,7 +91,9 @@ tracker_namespace_manager_has_prefix
tracker_namespace_manager_lookup_prefix
tracker_namespace_manager_new
tracker_namespace_manager_print_turtle
+tracker_namespace_manager_foreach
<SUBSECTION Standard>
+TrackerNamespaceManagerClass
TRACKER_TYPE_NAMESPACE_MANAGER
</SECTION>
@@ -161,6 +188,8 @@ tracker_sparql_connection_statistics_finish
tracker_sparql_connection_get_namespace_manager
tracker_sparql_connection_set_domain
tracker_sparql_connection_get_domain
+tracker_sparql_connection_get_dbus_connection
+tracker_sparql_connection_set_dbus_connection
<SUBSECTION Standard>
TrackerSparqlConnectionClass
TRACKER_SPARQL_CONNECTION
@@ -171,6 +200,8 @@ TRACKER_SPARQL_IS_CONNECTION_CLASS
TRACKER_SPARQL_TYPE_CONNECTION
TRACKER_SPARQL_TYPE_VALUE_TYPE
tracker_sparql_connection_get_type
+TRACKER_SPARQL_TYPE_CONNECTION_FLAGS
+tracker_sparql_connection_flags_get_type
<SUBSECTION Private>
TRACKER_DBUS_INTERFACE_RESOURCES
TRACKER_DBUS_INTERFACE_STATISTICS
@@ -197,6 +228,10 @@ tracker_sparql_statement_bind_int
tracker_sparql_statement_bind_double
tracker_sparql_statement_bind_string
tracker_sparql_statement_bind_boolean
+tracker_sparql_statement_get_connection
+tracker_sparql_statement_set_connection
+tracker_sparql_statement_get_sparql
+tracker_sparql_statement_set_sparql
<SUBSECTION Standard>
TrackerSparqlStatementClass
TRACKER_SPARQL_STATEMENT
@@ -269,6 +304,10 @@ TRACKER_NOTIFIER_CLASS
TRACKER_NOTIFIER_GET_CLASS
TRACKER_TYPE_NOTIFIER
tracker_notifier_get_type
+TRACKER_TYPE_NOTIFIER_EVENT_TYPE
+tracker_notifier_event_type_get_type
+TRACKER_TYPE_NOTIFIER_FLAGS
+tracker_notifier_flags_get_type
</SECTION>
<SECTION>
@@ -282,8 +321,5 @@ tracker_interface_age
tracker_check_version
<SUBSECTION>
-TRACKER_MAJOR_VERSION
-TRACKER_MINOR_VERSION
-TRACKER_MICRO_VERSION
TRACKER_CHECK_VERSION
</SECTION>
diff --git a/docs/reference/libtracker-sparql/meson.build b/docs/reference/libtracker-sparql/meson.build
index 193cded84..e86e0b459 100644
--- a/docs/reference/libtracker-sparql/meson.build
+++ b/docs/reference/libtracker-sparql/meson.build
@@ -28,9 +28,8 @@ example_files = [
gnome.gtkdoc('libtracker-sparql',
src_dir: sparqlinc,
- main_sgml: 'libtracker-sparql-docs.sgml',
- content_files: ['overview.sgml', 'examples.sgml', 'ontologies.sgml', 'private-store.xml',
'migrating-1to2.xml', example_files],
+ main_xml: 'libtracker-sparql-docs.xml',
+ content_files: ['overview.xml', 'examples.xml', 'ontologies.xml', 'private-store.xml',
'migrating-1to2.xml', example_files],
dependencies: tracker_sparql_dep,
- gobject_typesfile: 'libtracker-sparql.types',
fixxref_args: fixxref_args,
install: true)
diff --git a/docs/reference/libtracker-sparql/ontologies.sgml
b/docs/reference/libtracker-sparql/ontologies.xml
similarity index 100%
rename from docs/reference/libtracker-sparql/ontologies.sgml
rename to docs/reference/libtracker-sparql/ontologies.xml
diff --git a/docs/reference/libtracker-sparql/overview.sgml b/docs/reference/libtracker-sparql/overview.xml
similarity index 100%
rename from docs/reference/libtracker-sparql/overview.sgml
rename to docs/reference/libtracker-sparql/overview.xml
diff --git a/src/libtracker-sparql/tracker-connection.vala b/src/libtracker-sparql/tracker-connection.vala
index cdb6c36eb..70ef83218 100644
--- a/src/libtracker-sparql/tracker-connection.vala
+++ b/src/libtracker-sparql/tracker-connection.vala
@@ -136,11 +136,11 @@ public abstract class Tracker.Sparql.Connection : Object {
* which it won't support (i.e. an update for a read-only backend), you will
* see critical warnings.
*
- * When calling either tracker_sparql_connection_get(),
- * tracker_sparql_connection_get_direct() or the asynchronous variants of
- * these functions, a mutex is used to protect the loading of backends
- * against potential race conditions. For synchronous calls, this function
- * will always block if a previous connection get method has been called.
+ * When calling either tracker_sparql_connection_get(), or the asynchronous
+ * variants of these functions, a mutex is used to protect the loading of
+ * backends against potential race conditions. For synchronous calls, this
+ * function will always block if a previous connection get method has been
+ * called.
*
* All backends will call the D-Bus tracker-store API Wait() to make sure
* the store and databases are in the right state before any user based
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]