diff --git a/doc/flatpak-spawn.xml b/doc/flatpak-spawn.xml
index 751a4be3..2d02da4d 100644
--- a/doc/flatpak-spawn.xml
+++ b/doc/flatpak-spawn.xml
@@ -43,13 +43,14 @@
Unlike other flatpak commands, flatpak-spawn is available
to applications inside the sandbox. It runs COMMAND
- outside the sandbox, either in another sandbox, or on the host.
+ outside the sandbox: either in another sandbox, or on the host.
- flatpak-spawn uses the Flatpak portal to create a copy
- the sandbox it was called from, optionally using tighter permissions and
- the latest version of the app and runtime.
+ When called without , flatpak-spawn
+ uses the Flatpak portal to create a copy of the sandbox it was called from,
+ optionally using tighter permissions and optionally the latest version of the
+ app and runtime (see ).
@@ -98,7 +99,7 @@
- Make the spawned command exit if we do
+ Make the spawned command exit if the caller disappears from the session bus
@@ -130,10 +131,11 @@
- Run fully sandboxed.
+ Run fully sandboxed. See the documentation for the
+ option in flatpak-run1
- See the and
- options for selective file access.
+ See the and
+ options for selective file access.
@@ -172,7 +174,7 @@
Run the command unsandboxed on the host. This requires access to
- the org.freedesktop.Flatpak D-Bus interface
+ the org.freedesktop.Flatpak D-Bus interface.