man: document that journalctl --user requires Storage=persistent

Fixes: #25061

diff --git a/man/journalctl.xml b/man/journalctl.xml
index 683cb612498f95d02e933e17cfa8b9b98984818f..969bcaec0167c3731d300685c5650e7161e2da68 100644 (file)
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -119,7 +119,11 @@
         </para>
 
         <para>The <option>--user</option> option affects how <option>--unit=</option> arguments are
-        treated. See <option>--unit=</option>.</para></listitem>
+        treated. See <option>--unit=</option>.</para>
+
+        <para>Note that <option>--user</option> only works if persistent logging is enabled, via the
+        <varname>Storage=</varname> setting in
+        <citerefentry><refentrytitle>journald.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para></listitem>
       </varlistentry>
 
       <varlistentry>

diff --git a/man/journald.conf.xml b/man/journald.conf.xml
index 50c33e479294b1357acae730554c13aa67feef40..2642872407a13d77e0df521394a7ee04bf7583b0 100644 (file)
--- a/man/journald.conf.xml
+++ b/man/journald.conf.xml
@@ -95,6 +95,9 @@
         <filename>/var/log/journal/</filename>, as the <filename>systemd-journald@.service</filename> service
         file by default carries <varname>LogsDirectory=</varname>. To turn that off, add a unit file drop-in
         file that sets <varname>LogsDirectory=</varname> to an empty string.</para>
+
+        <para>Note that per-user journal files are not supported unless persistent storage is enabled, thus
+        making <command>journalctl --user</command> unavailable.</para>
         </listitem>
       </varlistentry>