From: Lennart Poettering <lennart@poettering.net>
Date: Thu, 30 Apr 2020 12:53:14 +0000 (+0200)
Subject: man: document the new -o cat feature
X-Git-Tag: v246-rc1~444^2~1
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e0e3d387268f5e1b6692c3bb3730ff349528927b;p=thirdparty%2Fsystemd.git

man: document the new -o cat feature
---

diff --git a/man/journalctl.xml b/man/journalctl.xml
index d6d475ed978..6e4728b0134 100644
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -374,9 +374,10 @@
                 <option>cat</option>
               </term>
               <listitem>
-                <para>generates a very terse output, only showing the
-                actual message of each journal entry with no metadata,
-                not even a timestamp.</para>
+                <para>generates a very terse output, only showing the actual message of each journal entry
+                with no metadata, not even a timestamp. If combined with the
+                <option>--output-fields=</option> option will output the listed fields for each log record,
+                instead of the message.</para>
               </listitem>
             </varlistentry>
 
@@ -398,10 +399,11 @@
       <varlistentry>
         <term><option>--output-fields=</option></term>
 
-        <listitem><para>A comma separated list of the fields which should be included in the output. This has an
-        effect only for the output modes which would normally show all fields (<option>verbose</option>,
-        <option>export</option>, <option>json</option>, <option>json-pretty</option>, <option>json-sse</option> and
-        <option>json-seq</option>). The <literal>__CURSOR</literal>, <literal>__REALTIME_TIMESTAMP</literal>,
+        <listitem><para>A comma separated list of the fields which should be included in the output. This has
+        an effect only for the output modes which would normally show all fields (<option>verbose</option>,
+        <option>export</option>, <option>json</option>, <option>json-pretty</option>,
+        <option>json-sse</option> and <option>json-seq</option>), as well as on <option>cat</option>. For the
+        former, the <literal>__CURSOR</literal>, <literal>__REALTIME_TIMESTAMP</literal>,
         <literal>__MONOTONIC_TIMESTAMP</literal>, and <literal>_BOOT_ID</literal> fields are always
         printed.</para></listitem>
       </varlistentry>