Merge pull request #30284 from YHNdnzj/fstab-wantedby-defaultdeps

[thirdparty/systemd.git] / man / sysupdate.d.xml

diff --git a/man/sysupdate.d.xml b/man/sysupdate.d.xml
index 60685aa12f533eeb746ebeb701a8be326b70f93b..b5c89811f5c0fe275fde20589d6a5a0f27b50eab 100644 (file)
--- a/man/sysupdate.d.xml
+++ b/man/sysupdate.d.xml
@@ -22,10 +22,11 @@
   </refnamediv>
 
   <refsynopsisdiv>
-    <para><literallayout><filename>/etc/sysupdate.d/*.conf</filename>
-<filename>/run/sysupdate.d/*.conf</filename>
-<filename>/usr/lib/sysupdate.d/*.conf</filename>
-    </literallayout></para>
+    <para><simplelist>
+      <member><filename>/etc/sysupdate.d/*.conf</filename></member>
+      <member><filename>/run/sysupdate.d/*.conf</filename></member>
+      <member><filename>/usr/lib/sysupdate.d/*.conf</filename></member>
+    </simplelist></para>
   </refsynopsisdiv>
 
   <refsect1>
@@ -539,6 +540,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 +625,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>
 
@@ -828,7 +840,7 @@ Path=auto
 MatchPattern=foobarOS_@v_verity
 MatchPartitionType=root-verity
 PartitionFlags=0
-PartitionReadOnly=1</programlisting></para>
+ReadOnly=1</programlisting></para>
 
       <para>The above defines the update mechanism for the Verity partition of the root file system. Verity
       partition images are downloaded from
@@ -858,7 +870,7 @@ Path=auto
 MatchPattern=foobarOS_@v
 MatchPartitionType=root
 PartitionFlags=0
-PartitionReadOnly=1</programlisting></para>
+ReadOnly=1</programlisting></para>
 
       <para>The above defines a matching transfer definition for the root file system.</para>