summaryrefslogtreecommitdiff
path: root/docs/reference
diff options
context:
space:
mode:
authorCarlos Garnacho <carlosg@gnome.org>2021-11-28 14:26:55 +0100
committerCarlos Garnacho <carlosg@gnome.org>2022-02-04 19:22:01 +0100
commitbb1f8963b3f1fcb330f5ca6cff1c3af476336c92 (patch)
tree2e80e260d6dafc501c5a4a07b4ce82977e0b4827 /docs/reference
parent3387e7659c6cde5efb781612f07f5b6cf9fbf0ef (diff)
downloadtracker-bb1f8963b3f1fcb330f5ca6cff1c3af476336c92.tar.gz
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.
Diffstat (limited to 'docs/reference')
-rw-r--r--docs/reference/libtracker-sparql/sparql-and-tracker.md13
1 files changed, 13 insertions, 0 deletions
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.