From: Lennart Poettering <lennart@poettering.net>
Date: Mon, 30 Sep 2024 15:29:35 +0000 (+0200)
Subject: man: drop /var/spool/ mention from file-hierarchy(7) man page
X-Git-Tag: v257-rc1~328^2~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b0201b36d2e0181d08530aaad496322812c4e77e;p=thirdparty%2Fsystemd.git

man: drop /var/spool/ mention from file-hierarchy(7) man page

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.
---

diff --git a/man/file-hierarchy.xml b/man/file-hierarchy.xml
index db045b7fe0b..4b92d596cbe 100644
--- a/man/file-hierarchy.xml
+++ b/man/file-hierarchy.xml
@@ -277,11 +277,6 @@
         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
@@ -658,10 +653,6 @@
       <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>