summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2016-07-19 15:24:23 -0400
committerLennart Poettering <lennart@poettering.net>2016-07-19 21:24:23 +0200
commitdfc6109fcd7cd8987ca77326eef25c0deb25abd9 (patch)
tree29c75c8fbd3a9a40433b9568f4ff695d14b56ac6
parent069a92c6581a2ee4fc0f0f9430f54412e6e3026b (diff)
man: mention that locale changes might require initramfs to be rebuilt (#3754)
https://bugzilla.redhat.com/show_bug.cgi?id=1151651 Also explain what localectl does a bit better: https://bugzilla.redhat.com/show_bug.cgi?id=1357861
-rw-r--r--man/localectl.xml17
1 files changed, 13 insertions, 4 deletions
diff --git a/man/localectl.xml b/man/localectl.xml
index 7def047f62..8d2becb5d9 100644
--- a/man/localectl.xml
+++ b/man/localectl.xml
@@ -60,7 +60,10 @@
<title>Description</title>
<para><command>localectl</command> may be used to query and change
- the system locale and keyboard layout settings.</para>
+ the system locale and keyboard layout settings. It communicates with
+ <citerefentry><refentrytitle>systemd-localed</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+ to modify files such as <filename>/etc/locale.conf</filename> and
+ <filename>/etc/vconsole.conf</filename>.</para>
<para>The system locale controls the language settings of system
services and of the UI before the user logs in, such as the
@@ -72,9 +75,14 @@
such as the display manager, as well as the default for users
after login.</para>
- <para>Use
+ <para>Note that the changes performed using this tool might require
+ the initramfs to be rebuilt to take effect during early system boot.
+ The initramfs is not rebuilt automatically by <filename>localectl</filename>.
+ </para>
+
+ <para>Note that
<citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
- to initialize the system locale for mounted (but not booted)
+ may be used to initialize the system locale for mounted (but not booted)
system images.</para>
</refsect1>
@@ -214,7 +222,8 @@
</ulink>,
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-localed.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
- <citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+ <citerefentry><refentrytitle>systemd-firstboot</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+ <citerefentry><refentrytitle>mkinitrd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
</para>
</refsect1>