From: Leon M. George <leon@georgemail.eu>
Date: Wed, 19 Oct 2022 15:22:48 +0000 (+0200)
Subject: man: document effect of --user on --unit with journalctl
X-Git-Tag: v252-rc3~21
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3d218676fc791fff7f72545405b645ab522a41ff;p=thirdparty%2Fsystemd.git

man: document effect of --user on --unit with journalctl

Relates to #25061.
---

diff --git a/man/journalctl.xml b/man/journalctl.xml
index 75427bc632e..5bf895fce44 100644
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -108,7 +108,10 @@
         <listitem><para>Show messages from system services and the kernel (with
         <option>--system</option>). Show messages from service of current user (with
         <option>--user</option>).  If neither is specified, show all messages that the user can see.
-        </para></listitem>
+        </para>
+
+        <para>The <option>--user</option> option affects how <option>--unit</option> arguments are
+        treated. See <option>--unit</option>.</para></listitem>
       </varlistentry>
 
       <varlistentry>
@@ -282,6 +285,9 @@
         <citerefentry><refentrytitle>systemd.slice</refentrytitle><manvolnum>5</manvolnum></citerefentry>
         unit, all logs of children of the slice will be shown.</para>
 
+        <para>With <option>--user</option>, all <option>--unit</option> arguments will be converted to match
+        user messages as if specified with <option>--user-unit</option>.</para>
+
         <para>This parameter can be specified multiple times.</para></listitem>
       </varlistentry>