man: add a bit of a warning to systemd-tmpfiles --purge

enr0n · bluca · commit 9ebcac3b5125 · 2024-06-15T00:00:53.000+01:00
Mention that by default, /home is managed by tmpfiles.d/home.conf, and
recommend that users run systemd-tmpfiles --dry-run --purge first to
see exactly what will be removed.
diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
@@ -150,7 +150,11 @@
       <varlistentry>
         <term><option>--purge</option></term>
         <listitem><para>If this option is passed, all files and directories created by a
-        <filename>tmpfiles.d/</filename> entry will be deleted.</para>
+        <filename>tmpfiles.d/</filename> entry will be deleted. Keep in mind that by default,
+        <filename>/home</filename> is created by <command>systemd-tmpfiles</command>
+        (see <filename>/usr/lib/tmpfiles.d/home.conf</filename>). Therefore it is recommended
+        to first run <command>systemd-tmpfiles --dry-run --purge</command> to be certain which files
+        and directories will be deleted.</para>
 
         <xi:include href="version-info.xml" xpointer="v256"/></listitem>
       </varlistentry>
