]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man,units: drop "temporary" from description of systemd-tmpfiles
authorMike Yuan <me@yhndnzj.com>
Sat, 15 Jun 2024 15:27:33 +0000 (17:27 +0200)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Sat, 15 Jun 2024 17:08:35 +0000 (19:08 +0200)
Historically, systemd-tmpfiles was designed to manager temporary
files, but nowadays it has become a generic tool for managing
all kinds of files. To avoid user confusion, let's remove "temporary"
from the tool's description.

As discussed in #33349

man/systemd-tmpfiles.xml
units/systemd-tmpfiles-setup.service
units/user/systemd-tmpfiles-setup.service

index 6f3ec66611ff3c9440a173434104ddf5d83d3a3d..9767aead85184b604b980171f6a42410af3c4cbf 100644 (file)
   <refsect1>
     <title>Description</title>
 
-    <para><command>systemd-tmpfiles</command> creates, deletes, and cleans up volatile and temporary files
-    and directories, using the configuration file format and location specified in
-    <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>. It must
+    <para><command>systemd-tmpfiles</command> creates, deletes, and cleans up files and directories, using
+    the configuration file format and location specified in
+    <citerefentry><refentrytitle>tmpfiles.d</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
+    Historically, it was designed to manage volatile and temporary files, as the name suggests, but it provides
+    generic file management functionality and can be used to manage any kind of files. It must
     be invoked with one or more commands <option>--create</option>, <option>--remove</option>, and
     <option>--clean</option>, to select the respective subset of operations.</para>
 
index 6cae32850f4fa72b547cc7fd7e9cd085ccb6ae98..b92beb73141924fda2d6631dcb7f4339d5c2a909 100644 (file)
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Create Volatile Files and Directories
+Description=Create System Files and Directories
 Documentation=man:tmpfiles.d(5) man:systemd-tmpfiles(8)
 
 DefaultDependencies=no
index 156689edcd8655db35db3b32c9005d514b4fe6af..54e453c4fccd9bdc813b93e04d4e84a65163228c 100644 (file)
@@ -8,7 +8,7 @@
 #  (at your option) any later version.
 
 [Unit]
-Description=Create User's Volatile Files and Directories
+Description=Create User Files and Directories
 Documentation=man:tmpfiles.d(5) man:systemd-tmpfiles(8)
 DefaultDependencies=no
 Conflicts=shutdown.target