From 49fddcd355a1404913a0d2350cf5fd146e149631 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Fri, 7 Jan 2022 16:38:18 +0100 Subject: [PATCH] man: refer to os-release(5) for description of files in the same format --- man/locale.conf.xml | 18 ++++++++---------- man/machine-info.xml | 14 +++++++------- man/os-release.xml | 6 +++--- man/vconsole.conf.xml | 14 +++++++------- 4 files changed, 25 insertions(+), 27 deletions(-) diff --git a/man/locale.conf.xml b/man/locale.conf.xml index df19f1a435..24be105d4f 100644 --- a/man/locale.conf.xml +++ b/man/locale.conf.xml @@ -30,14 +30,13 @@ system-wide locale settings. It is read at early boot by systemd1. - The basic file format of locale.conf is - a newline-separated list of environment-like shell-compatible - variable assignments, ignoring comments and empty lines. - It is possible to source the configuration - from shell scripts, however, beyond mere variable assignments, no - shell features are supported, allowing applications to read the - file without implementing a shell compatible execution - engine. + The format of locale.conf is a newline-separated list of environment-like + shell-compatible variable assignments, ignoring comments and empty lines. It is possible to source the + configuration from shell scripts, however, beyond mere variable assignments, no shell features are + supported, allowing applications to read the file without implementing a shell compatible execution + engine. See + os-release5 for a + detailed description of the format. Note that the kernel command line options locale.LANG=, @@ -59,7 +58,7 @@ The locale settings configured in /etc/locale.conf are system-wide and are inherited by every service or user, unless overridden or unset by - individual programs or individual users. + individual programs or users. Depending on the operating system, other configuration files might be checked for locale configuration as well, however only as @@ -126,5 +125,4 @@ LC_MESSAGES=en_US.UTF-8 systemd-firstboot1 - diff --git a/man/machine-info.xml b/man/machine-info.xml index d324856d07..0f57cbdb88 100644 --- a/man/machine-info.xml +++ b/man/machine-info.xml @@ -29,13 +29,13 @@ The /etc/machine-info file contains machine metadata. - The basic file format of machine-info - is a newline-separated list of environment-like shell-compatible - variable assignments. It is possible to source the configuration - from shell scripts, however, beyond mere variable assignments no - shell features are supported, allowing applications to read the - file without implementing a shell compatible execution - engine. + The format of machine-info is a newline-separated list of environment-like + shell-compatible variable assignments, ignoring comments and empty lines. It is possible to source the + configuration from shell scripts, however, beyond mere variable assignments no shell features are + supported, allowing applications to read the file without implementing a shell compatible execution + engine. See + os-release5 for a + detailed description of the format. /etc/machine-info contains metadata about the machine that is set by the user or administrator. The settings configured here have the highest precedence. When not set, appropriate diff --git a/man/os-release.xml b/man/os-release.xml index 1826a60d1a..f5d6756f89 100644 --- a/man/os-release.xml +++ b/man/os-release.xml @@ -35,7 +35,7 @@ /usr/lib/os-release files contain operating system identification data. - The basic file format of os-release is a newline-separated list of + The format of os-release is a newline-separated list of environment-like shell-compatible variable assignments. It is possible to source the configuration from Bourne shell scripts, however, beyond mere variable assignments, no shell features are supported (this means variable expansion is explicitly not supported), allowing applications to read the file without @@ -44,8 +44,8 @@ 0–9. (Assignments that do not include these special characters may be enclosed in quotes too, but this is optional.) Shell special characters ("$", quotes, backslash, backtick) must be escaped with backslashes, following shell style. All strings should be in UTF-8 encoding, and non-printable characters should not - be used. It is not supported to concatenate multiple individually quoted strings. Lines beginning with - "#" shall be ignored as comments. Blank lines are permitted and ignored. + be used. Concatenation of multiple individually quoted strings is not supported. Lines beginning with "#" + are treated as comments. Blank lines are permitted and ignored. The file /etc/os-release takes precedence over /usr/lib/os-release. diff --git a/man/vconsole.conf.xml b/man/vconsole.conf.xml index 378812bd2a..e4e2864ff2 100644 --- a/man/vconsole.conf.xml +++ b/man/vconsole.conf.xml @@ -32,13 +32,13 @@ You can safely mask this file if you want to avoid this kind of initialization. - The basic file format of the - vconsole.conf is a newline-separated list of - environment-like shell-compatible variable assignments. It is - possible to source the configuration from shell scripts, however, - beyond mere variable assignments no shell features are supported, - allowing applications to read the file without implementing a - shell compatible execution engine. + The format of vconsole.conf is a newline-separated list of environment-like + shell-compatible variable assignments, ignoring comments and empty lines. It is possible to source the + configuration from shell scripts, however, beyond mere variable assignments no shell features are + supported, allowing applications to read the file without implementing a shell compatible execution + engine. See + os-release5 for a + detailed description of the format. Note that the kernel command line options vconsole.keymap=, -- 2.25.1