From 77a9e8de6572db6ba5ca49023937b67fc835f356 Mon Sep 17 00:00:00 2001
From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Mon, 15 Jul 2013 21:03:17 -0400
Subject: man: add note about paging and colors to journalctl(1)

---
 man/journalctl.xml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

(limited to 'man/journalctl.xml')

diff --git a/man/journalctl.xml b/man/journalctl.xml
index 71b1babb10..b8b29b4cb5 100644
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -107,6 +107,20 @@
                 users who are members of the <literal>adm</literal>
                 group get access to the system journal and the
                 journals of other users.</para>
+
+                <para>The output is paged through
+                <command>less</command> by default, and long lines are
+                "truncated" to screen width. The hidden part can be
+                viewed by using the left-arrow and right-arrow
+                keys. Paging can be disabled, see
+                <option>--no-pager</option> and section Environment
+                below.</para>
+
+                <para>When outputing to a tty, lines are colored
+                according to priority: lines of level ERROR and higher
+                are colored red, lines of level NOTICE and higher are
+                highlighted, and other lines are displayed normally.
+                </para>
         </refsect1>
 
         <refsect1>
-- 
cgit v1.2.3-54-g00ecf