From: Zbigniew Jędrzejewski-Szmek Date: Tue, 16 Jul 2013 01:03:17 +0000 (-0400) Subject: man: add note about paging and colors to journalctl(1) X-Git-Tag: v206~94 X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=77a9e8de6572db6ba5ca49023937b67fc835f356 man: add note about paging and colors to journalctl(1) --- diff --git a/TODO b/TODO index 88d9ae60b..3fa384cf2 100644 --- a/TODO +++ b/TODO @@ -357,7 +357,7 @@ Features: - refuse taking lower-case variable names in sd_journal_send() and friends. - journald: we currently rotate only after MaxUse+MaxFilesize has been reached. - journal: deal nicely with byte-by-byte copied files, especially regards header - - journalctl: show multiline log messages sanely, expand tabs, and show all valid utf8 messages + - journalctl: expand tabs - journal: store euid in journal if it differs from uid - journal: sanely deal with entries which are larger than the individual file size, but where the components would fit - Replace utmp, wtmp, btmp, and lastlog completely with journal diff --git a/man/journalctl.xml b/man/journalctl.xml index 71b1babb1..b8b29b4cb 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -107,6 +107,20 @@ users who are members of the adm group get access to the system journal and the journals of other users. + + The output is paged through + less 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 + and section Environment + below. + + 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. +