From efafe2c4f554416172532c7714d99057cbc66403 Mon Sep 17 00:00:00 2001
From: Simon McVittie <smcv@collabora.com>
Date: Fri, 5 Feb 2021 11:01:05 +0000
Subject: [PATCH] wrap: Document automatic handling of ${runtime}/files/

Signed-off-by: Simon McVittie <smcv@collabora.com>
---
 pressure-vessel/wrap.1.md | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/pressure-vessel/wrap.1.md b/pressure-vessel/wrap.1.md
index 028852c42..25c5b00a5 100644
--- a/pressure-vessel/wrap.1.md
+++ b/pressure-vessel/wrap.1.md
@@ -96,12 +96,16 @@ pressure-vessel-wrap - run programs in a bubblewrap container
 
 `--runtime` *PATH*
 :   Use *PATH* to provide /usr in the container.
-    If *PATH*/usr exists, *PATH* is assumed to be a complete sysroot
+    If *PATH*/files/ is a directory, *PATH*/files/ is used as the source
+    of runtime files: this is appropriate for Flatpak-style runtimes that
+    contain *PATH*/files/ and *PATH*/metadata. Otherwise, *PATH* is used
+    directly.
+    If *PATH*/files/usr or *PATH*/usr exists, the source of runtime files
+    is assumed to be a complete sysroot
     (containing bin/sh, usr/bin/env and many other OS files).
-    Otherwise, *PATH* is assumed to be a merged-/usr environment
+    Otherwise, it is assumed to be a merged-/usr environment
     (containing bin/sh, bin/env and many other OS files).
-    For example, the `files` subdirectory of a Flatpak runtime is a
-    suitable value for *PATH*.
+    For example, a Flatpak runtime is a suitable value for *PATH*.
 
 `--runtime-base` *PATH*
 :   If `--runtime` specifies a relative path, look for it relative
-- 
GitLab