]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
sysupdate: Add documentation for new MatchPattern behavior 29295/head
authorValentin David <me@valentindavid.com>
Sun, 24 Sep 2023 15:30:41 +0000 (17:30 +0200)
committerValentin David <me@valentindavid.com>
Thu, 28 Sep 2023 09:41:29 +0000 (11:41 +0200)
man/sysupdate.d.xml

index 60685aa12f533eeb746ebeb701a8be326b70f93b..ec0c57fc788981c914f0d2a06251e3c2f123f3cb 100644 (file)
         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>
         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>