[tracker/wip/carlosg/serialize-api: 26/26] docs: Add documentation blurb about DESCRIBE resultset format
- From: Carlos Garnacho <carlosg src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [tracker/wip/carlosg/serialize-api: 26/26] docs: Add documentation blurb about DESCRIBE resultset format
- Date: Sun, 19 Dec 2021 10:35:02 +0000 (UTC)
commit 06f359a795689ecb3816b357ba7f021ad20e10b7
Author: Carlos Garnacho <carlosg gnome org>
Date: Sun Nov 28 14:26:55 2021 +0100
docs: Add documentation blurb about DESCRIBE resultset format
It is unclear if it is a deviation or not from the spec, but anyhow it's
good to spell the decision out.
docs/reference/libtracker-sparql/sparql-and-tracker.md | 13 +++++++++++++
1 file changed, 13 insertions(+)
---
diff --git a/docs/reference/libtracker-sparql/sparql-and-tracker.md
b/docs/reference/libtracker-sparql/sparql-and-tracker.md
index dc6ba79c6..78a39932f 100644
--- a/docs/reference/libtracker-sparql/sparql-and-tracker.md
+++ b/docs/reference/libtracker-sparql/sparql-and-tracker.md
@@ -262,3 +262,16 @@ this full-text search mechanism, by toggling the
`tracker:fulltextIndexed` property on in the
text `rdf:Property` instances. See the documentation
on [defining ontologies](ontologies.html).
+
+## DESCRIBE queries
+
+The [SPARQL documentation](https://www.w3.org/TR/sparql11-query/#describe)
+says:
+
+```
+The DESCRIBE form returns a single result RDF graph containing RDF data about resources.
+```
+
+In order to allow serialization to RDF formats that allow expressing graph information
+(e.g. Trig), DESCRIBE resultsets have 4 columns for subject / predicate / object / graph
+information.
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]