From 9a8a491312839e389c460c74a54b8ad403f5f2c9 Mon Sep 17 00:00:00 2001
From: Colin Walters <walters@verbum.org>
Date: Fri, 6 Dec 2024 14:57:19 -0500
Subject: [PATCH] man: Note semantics combining `root.transient` with
 `composefs.enabled`

It's all quite confusing having to reason about both the pre-composefs
ostree and the composefs version. But hopefully soon we more firmly
leave behind that first legacy.

Signed-off-by: Colin Walters <walters@verbum.org>
---
 man/ostree-prepare-root.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/man/ostree-prepare-root.xml b/man/ostree-prepare-root.xml
index 70371b7bc5..ae269ef430 100644
--- a/man/ostree-prepare-root.xml
+++ b/man/ostree-prepare-root.xml
@@ -130,7 +130,8 @@ License along with this library. If not, see <https://www.gnu.org/licenses/>.
                    directory is *not* a symlink to <literal>/var/opt</literal>, but is just an empty directory.
                 </para>
                 <para>
-                   Note the <literal>/usr</literal> mount point remains read-only by default.  This option is independent of <literal>etc.transient</literal> and <literal>sysroot.readonly</literal>;
+                   If this option is not combined with <literal>composefs.enabled</literal>, then <literal>/usr</literal> mount point remains read-only by default.
+                   This option is independent of <literal>etc.transient</literal> and <literal>sysroot.readonly</literal>;
                    it is supported for example to have <literal>root.transient=true</literal> but <literal>etc.transient=false</literal> in which case changes to <literal>/etc</literal> continue
                    to persist across updates, with the default OSTree 3-way merge applied.
                 </para></listitem>