[tracker/wip/carlosg/portal: 29/40] docs: Add tracker3-xdg-portal manpage

[Carlos Garnacho <carlosg src gnome org>]

commit a5fb027ab60ed4c67b589222594b649806c210ef
Author: Carlos Garnacho <carlosg gnome org>
Date:   Fri Jan 24 15:31:38 2020 +0100

    docs: Add tracker3-xdg-portal manpage

 docs/manpages/meson.build              |  4 +++-
 docs/manpages/tracker-xdg-portal.1.txt | 43 ++++++++++++++++++++++++++++++++++
 2 files changed, 46 insertions(+), 1 deletion(-)
---
diff --git a/docs/manpages/meson.build b/docs/manpages/meson.build
index be2fa58b5..79facbf5f 100644
--- a/docs/manpages/meson.build
+++ b/docs/manpages/meson.build
@@ -4,7 +4,8 @@ manpages = [
     'import',
     'info',
     'sparql',
-    'sql'
+    'sql',
+    'xdg-portal',
 ]
 
 foreach m : manpages
@@ -35,3 +36,4 @@ foreach m : manpages
     install_dir: get_option('mandir') / 'man1',
   )
 endforeach
+
diff --git a/docs/manpages/tracker-xdg-portal.1.txt b/docs/manpages/tracker-xdg-portal.1.txt
new file mode 100644
index 000000000..29d2ceb65
--- /dev/null
+++ b/docs/manpages/tracker-xdg-portal.1.txt
@@ -0,0 +1,43 @@
+tracker-xdg-portal(1)
+=====================
+
+== NAME
+
+tracker-xdg-portal - Portal to Tracker endpoints
+
+== SYNOPSIS
+
+....
+tracker-xdg-portal [--version | -v]
+....
+
+== DESCRIPTION
+
+This daemon allows access to Tracker endpoints in a controlled manner.
+By default access to every service is disallowed, services may be whitelisted
+through additional policy in the _.flatpak-info_ file.
+
+When whitelisting services, the policy may define specific graph names to
+allow access to, the _default_ keyword to allow access to the default
+unnamed graph, or _*_ keyword to allow access to all graphs.
+
+== CONFIGURATION
+
+When interacting with sandboxed clients, the service expects the following format in the _.flatpak-info_ 
file:
+
+  [Policy Tracker3]
+  dbus:org.example.SparqlEndpoint1=graphA;graphB;default
+  dbus:org.example.SparqlEndpoint2=*
+
+This will allow access to the endpoints behind the *org.example.SparqlEndpoint1* and 
*org.example.SparqlEndpoint2* bus names. Only to the *graphA* and *graphB* graph IRIs and the default unnamed 
graph on the first endpoint, and to all graphs in the second.
+
+This policy can be set when building or running the sandboxed application through the --add-policy option. 
This can be set via **finish-args** in the flatpak manifest, specified along the build chain in 
*flatpak-build-finish*(1), or modified at start time with *flatpak-run*(1). For example:
+
+  $ flatpak run \
+    --add-policy=Tracker3.dbus:org.example.SparqlEndpoint1=graphA;graphB;default \
+    --add-policy=Tracker3.dbus:org.example.SparqlEndpoint2=* \
+    org.freedesktop.TrackerSandbox
+
+== SEE ALSO
+
+*flatpak-build-finish*(1), *flatpak-override*(1), *flatpak-run*(1)