Skip to content

Commit

Permalink
man: Note semantics combining root.transient with composefs.enabled
Browse files Browse the repository at this point in the history
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 <[email protected]>
  • Loading branch information
cgwalters committed Dec 6, 2024
1 parent 1858d3d commit 9a8a491
Showing 1 changed file with 2 additions and 1 deletion.
3 changes: 2 additions & 1 deletion man/ostree-prepare-root.xml
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down

0 comments on commit 9a8a491

Please sign in to comment.