From d4205751d4643c272059a3728045929dd0e5e800 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Thu, 15 Nov 2012 23:03:31 +0100 Subject: journal: implement message catalog The message catalog can be used to attach short help texts to log lines, keyed by their MESSAGE_ID= fields. This is useful to help the administrator understand the context and cause of a message, find possible solutions and find further related documentation. Since this is keyed off MESSAGE_ID= this will only work for native journal messages. The message catalog supports i18n, and is useful to augment english language system messages with explanations in the local language. This commit only includes short explanatory messages for a few example message IDs, we'll add more complete documentation for the relevant systemd messages later on. --- man/journalctl.xml | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) (limited to 'man') diff --git a/man/journalctl.xml b/man/journalctl.xml index 026bb22940..e7fff0c9dc 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -232,6 +232,25 @@ even a timestamp. + + + + + Augment log lines with + explanation texts from the message + catalog. This will add explanatory + help texts to log messages in the + output where this is available. These + short help texts will explain the + context of an error or log event, + possible solutions, as well as + pointers to support forums, developer + documentation and any other relevant + manuals. Note that help texts are not + available for all messages but only + for selected ones. + + @@ -404,6 +423,26 @@ journal files. + + + + List the contents of + the message catalog, as table of + message IDs plus their short + description strings. + + + + + + Update the message + catalog index. This command needs to + be executed each time new catalog + files are installed, removed or + updated to rebuild the binary catalog + index. + + -- cgit v1.2.3-54-g00ecf