diff --git a/man/locale.conf.xml b/man/locale.conf.xml
index 2fe731113a..1405dda3fd 100644
--- a/man/locale.conf.xml
+++ b/man/locale.conf.xml
@@ -91,12 +91,14 @@
might be checked for locale configuration as well, however only as
fallback.
- localectl1
+ /etc/vconsole.conf is usually created and updated
+ using
+ systemd-localed.service8.
+ localectl1
may be used to alter the settings in this file during runtime from
the command line. Use
systemd-firstboot1
- to initialize them on mounted (but not booted) system
- images.
+ to initialize them on mounted (but not booted) system images.
diff --git a/man/vconsole.conf.xml b/man/vconsole.conf.xml
index fa30ca6569..4a6672cbae 100644
--- a/man/vconsole.conf.xml
+++ b/man/vconsole.conf.xml
@@ -78,6 +78,13 @@
Depending on the operating system other configuration files
might be checked for configuration of the virtual console as well,
however only as fallback.
+
+ /etc/vconsole.conf is usually created and updated
+ using
+ systemd-localed.service8.
+ localectl1
+ may be used to instruct systemd-localed.service to
+ query or update configuration.
diff --git a/src/locale/keymap-util.c b/src/locale/keymap-util.c
index da72bee4a9..105d9b0ee4 100644
--- a/src/locale/keymap-util.c
+++ b/src/locale/keymap-util.c
@@ -361,8 +361,9 @@ int x11_write_data(Context *c) {
fchmod(fileno(f), 0644);
- fputs("# Read and parsed by systemd-localed. It's probably wise not to edit this file\n"
- "# manually too freely.\n"
+ fputs("# Written by systemd-localed(8), read by systemd-localed and Xorg. It's\n"
+ "# probably wise not to edit this file manually. Use localectl(1) to\n"
+ "# instruct systemd-localed to update it.\n"
"Section \"InputClass\"\n"
" Identifier \"system-keyboard\"\n"
" MatchIsKeyboard \"on\"\n", f);