From: Lennart Poettering <lennart@poettering.net>
Date: Wed, 24 Jul 2019 07:59:38 +0000 (+0200)
Subject: man: highlight the different concepts behind h/H and t/T
X-Git-Tag: v243-rc1~54
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f3d3a9ca0734c298cc3bf08f8c4907dd19ee9939;p=thirdparty%2Fsystemd.git

man: highlight the different concepts behind h/H and t/T

Fixes: #13151
---

diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index f097045b7bb..dce05c364fe 100644
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -380,63 +380,64 @@ L     /tmp/foobar -    -    -     -   /dev/null</programlisting>
 
         <varlistentry>
           <term><varname>t</varname></term>
-          <listitem><para>Set extended attributes. Lines of this type
-          accept shell-style globs in place of normal path names.
-          This can be useful for setting SMACK labels. Does not follow
-          symlinks.</para></listitem>
+          <listitem><para>Set extended attributes, see <citerefentry
+          project='man-pages'><refentrytitle>attr</refentrytitle>
+          <manvolnum>5</manvolnum></citerefentry> for details. The argument field should take one or more
+          assignment expressions in the form
+          <replaceable>namespace</replaceable>.<replaceable>attribute</replaceable>=<replaceable>value</replaceable>,
+          for examples see below. Lines of this type accept shell-style globs in place of normal path
+          names. This can be useful for setting SMACK labels. Does not follow symlinks.</para>
+
+          <para>Please note that extended attributes settable with this line type are a different concept
+          from the Linux file attributes settable with <varname>h</varname>/<varname>H</varname>, see
+          below.</para></listitem>
         </varlistentry>
 
         <varlistentry>
           <term><varname>T</varname></term>
-          <listitem><para>Recursively set extended attributes. Lines
-          of this type accept shell-style globs in place of normal
-          path names.  This can be useful for setting SMACK
-          labels. Does not follow symlinks.  </para></listitem>
+          <listitem><para>Same as <varname>t</varname>, but operates recursively.</para></listitem>
         </varlistentry>
 
         <varlistentry>
           <term><varname>h</varname></term>
-          <listitem><para>Set file/directory attributes. Lines of this type
-          accept shell-style globs in place of normal path names.</para>
+          <listitem><para>Set Linux file/directory attributes. Lines of this type accept shell-style globs in
+          place of normal path names.</para>
 
-          <para>The format of the argument field is <varname>[+-=][aAcCdDeijPsStTu] </varname>. The prefix
+          <para>The format of the argument field is <varname>[+-=][aAcCdDeijPsStTu]</varname>. The prefix
           <varname>+</varname> (the default one) causes the attribute(s) to be added; <varname>-</varname>
           causes the attribute(s) to be removed; <varname>=</varname> causes the attributes to be set exactly
           as the following letters. The letters <literal>aAcCdDeijPsStTu</literal> select the new attributes
           for the files, see <citerefentry project='man-pages'><refentrytitle>chattr</refentrytitle>
           <manvolnum>1</manvolnum></citerefentry> for further information.
           </para>
-          <para>Passing only <varname>=</varname> as argument resets
-          all the file attributes listed above. It has to be pointed
-          out that the <varname>=</varname> prefix limits itself to
-          the attributes corresponding to the letters listed here. All
-          other attributes will be left untouched. Does not follow
-          symlinks.</para>
-          </listitem>
+
+          <para>Passing only <varname>=</varname> as argument resets all the file attributes listed above. It
+          has to be pointed out that the <varname>=</varname> prefix limits itself to the attributes
+          corresponding to the letters listed here. All other attributes will be left untouched. Does not
+          follow symlinks.</para>
+
+          <para>Please note that the Linux file attributes settable with this line type are a different
+          concept from the extended attributes settable with <varname>t</varname>/<varname>T</varname>,
+          see above.</para></listitem>
         </varlistentry>
 
         <varlistentry>
           <term><varname>H</varname></term>
-          <listitem><para>Recursively set file/directory attributes. Lines
-          of this type accept shell-style globs in place of normal
-          path names. Does not follow symlinks.
-          </para></listitem>
+          <listitem><para>Sames as <varname>h</varname>, but operates recursively.</para></listitem>
         </varlistentry>
 
         <varlistentry>
           <term><varname>a</varname></term>
           <term><varname>a+</varname></term>
-          <listitem><para>Set POSIX ACLs (access control lists). If
-          suffixed with <varname>+</varname>, the specified entries will
-          be added to the existing set.
-          <command>systemd-tmpfiles</command> will automatically add
-          the required base entries for user and group based on the
-          access mode of the file, unless base entries already exist
-          or are explicitly specified. The mask will be added if not
-          specified explicitly or already present. Lines of this type
-          accept shell-style globs in place of normal path names. This
-          can be useful for allowing additional access to certain
-          files. Does not follow symlinks.</para></listitem>
+          <listitem><para>Set POSIX ACLs (access control lists), see <citerefentry
+          project='man-pages'><refentrytitle>acl</refentrytitle>
+          <manvolnum>5</manvolnum></citerefentry>. If suffixed with <varname>+</varname>, the specified
+          entries will be added to the existing set. <command>systemd-tmpfiles</command> will automatically
+          add the required base entries for user and group based on the access mode of the file, unless base
+          entries already exist or are explicitly specified. The mask will be added if not specified
+          explicitly or already present. Lines of this type accept shell-style globs in place of normal path
+          names. This can be useful for allowing additional access to certain files. Does not follow
+          symlinks.</para></listitem>
         </varlistentry>
 
         <varlistentry>