From aedeaf745028a463150fd6d2b1aca778797735ac Mon Sep 17 00:00:00 2001
From: Nick Rosbrook <enr0n@ubuntu.com>
Date: Fri, 14 Jun 2024 17:31:22 -0400
Subject: [PATCH] man: add a bit of a warning to systemd-tmpfiles --purge

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.

(cherry picked from commit 9ebcac3b5125a8b0b11f371731ea167cd4684adc)
---
 man/systemd-tmpfiles.xml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
index 008bff62da..6f3ec66611 100644
--- 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>