cat: add --stderr-priority option

[thirdparty/systemd.git] / man / systemd-cat.xml

diff --git a/man/systemd-cat.xml b/man/systemd-cat.xml
index 432b524a4cdc2242e046d4173bc0fc0aa74df56f..446fa4ba31bf0692d83fd8ae7d66ad9f7baa332b 100644 (file)
--- a/man/systemd-cat.xml
+++ b/man/systemd-cat.xml
@@ -4,8 +4,6 @@
 
 <!--
   SPDX-License-Identifier: LGPL-2.1+
-
-  Copyright 2012 Lennart Poettering
 -->
 
 <refentry id="systemd-cat"
@@ -14,15 +12,6 @@
   <refentryinfo>
     <title>systemd-cat</title>
     <productname>systemd</productname>
-
-    <authorgroup>
-      <author>
-        <contrib>Developer</contrib>
-        <firstname>Lennart</firstname>
-        <surname>Poettering</surname>
-        <email>lennart@poettering.net</email>
-      </author>
-    </authorgroup>
   </refentryinfo>
 
   <refmeta>
@@ -103,6 +92,29 @@
         see <option>--level-prefix=</option> below.</para></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><option>--stderr-priority=</option></term>
+
+        <listitem><para>Specifies the default priority level for
+        messages from the process's standard error output (stderr).
+        Usage of this option is the same as the
+        <option>--priority=</option> option, above, and both can be
+        used at once. When both are used, <option>--priority=</option>
+        will specify the default priority for standard output (stdout).
+        </para>
+
+        <para>If <option>--stderr-priority=</option> is not specified,
+        messages from stderr will still be logged, with the same
+        default priority level as stdout.</para>
+
+        <para>Also, note that when stdout and stderr use the same
+        default priority, the messages will be strictly ordered,
+        because one channel is used for both. When the default priority
+        differs, two channels are used, and so stdout messages will not
+        be strictly ordered with respect to stderr messages - though
+        they will tend to be approximately ordered.</para></listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><option>--level-prefix=</option></term>