man: drop /var/spool/ mention from file-hierarchy(7) man page
authorLennart Poettering <lennart@poettering.net>
Mon, 30 Sep 2024 15:29:35 +0000 (17:29 +0200)
committerLuca Boccassi <luca.boccassi@gmail.com>
Tue, 8 Oct 2024 15:39:12 +0000 (16:39 +0100)
Today it seems this is mostly used by mail and printer servers, and it's
not clear to me at all what the property is that makes
/var/spool/<package> the better place for the relevant data than
/var/lib/<package>.

Hence, in the interest of shortening the spec, let's not mention the dir
anymore. In particular as the dir really isn't used by us much, for
example we do not have a counterpart for RuntimeDirectory=,
StateDirectory=, … that would cover the spool.

Since most systems these days we care about probably come *without* a
printer or mail server, let's maybe no mention this in the man page that
is supposed to discuss the rough skeleton how things are set up. After
all, people are supposed to exend the skeleton with their stuff, and
this sounds more like a case for an extension of the skeleton instead of
being considered part of the skeleton itself.

(cherry picked from commit b0201b36d2e0181d08530aaad496322812c4e77e)

man/file-hierarchy.xml

index db045b7fe0b2a6be6cc3fecd3b97ba78fa675d31..4b92d596cbeb56acf7b1176f800076f918e6506b 100644 (file)
         calls.</para></listitem>
       </varlistentry>
 
-      <varlistentry>
-        <term><filename>/var/spool/</filename></term>
-        <listitem><para>Persistent system spool data, such as printer or mail queues.</para></listitem>
-      </varlistentry>
-
       <varlistentry>
         <term><filename>/var/tmp/</filename></term>
         <listitem><para>The place for larger and persistent temporary files. In contrast to
       <entry><filename>/var/log/<replaceable>package</replaceable>/</filename></entry>
       <entry>Persistent log data of the package. As above, the package should make sure to create this directory if necessary, possibly using <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry> or <varname>LogsDirectory=</varname> (see <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>), as it might be missing.</entry>
           </row>
-          <row>
-      <entry><filename>/var/spool/<replaceable>package</replaceable>/</filename></entry>
-      <entry>Persistent spool/queue data of the package. As above, the package should make sure to create this directory if necessary, as it might be missing.</entry>
-          </row>
         </tbody>
       </tgroup>
     </table>