From: Valentin David <me@valentindavid.com>
Date: Sun, 24 Sep 2023 15:30:41 +0000 (+0200)
Subject: sysupdate: Add documentation for new MatchPattern behavior
X-Git-Tag: v255-rc1~401^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=deafbeb0b92a3a84ed71538ea6fd2bc7b3071bf1;p=thirdparty%2Fsystemd.git

sysupdate: Add documentation for new MatchPattern behavior
---

diff --git a/man/sysupdate.d.xml b/man/sysupdate.d.xml
index 60685aa12f5..ec0c57fc788 100644
--- a/man/sysupdate.d.xml
+++ b/man/sysupdate.d.xml
@@ -539,6 +539,11 @@
         wildcard, so that a version identifier may be extracted from the filename. All other wildcards are
         optional.</para>
 
+        <para>If the source type is <constant>regular-file</constant> or <constant>directory</constant>, the
+        pattern may contain slash characters. In this case it will match the file or directory in
+        corresponding subdirectory. For example <literal>MatchPattern=foo_@v/bar.efi</literal> will match
+        <literal>bar.efi</literal> in directory <literal>foo_1</literal>. </para>
+
         <xi:include href="version-info.xml" xpointer="v251"/></listitem>
       </varlistentry>
     </variablelist>
@@ -619,6 +624,12 @@
         of new versions to install. If multiple patterns are specified, the first specified is used for
         naming newly installed versions.</para>
 
+        <para>If the target type is <constant>regular-file</constant> or <constant>directory</constant>, the
+        pattern may contain slash characters. In this case it will match the file or directory in
+        corresponding subdirectory. For example <literal>MatchPattern=foo_@v/bar.efi</literal> will match
+        <literal>bar.efi</literal> in directory <literal>foo_1</literal>. Directories in the path will be
+        created when file is installed. Empty directories will be removed when file is removed.</para>
+
         <xi:include href="version-info.xml" xpointer="v251"/></listitem>
       </varlistentry>