]> git.ipfire.org Git - thirdparty/systemd.git/blobdiff - man/localectl.xml
Add SPDX license identifiers to man pages
[thirdparty/systemd.git] / man / localectl.xml
index caf963ae5e535c775273765e77b1951d190f48ba..858854104195088314abe4d08d08694361798294 100644 (file)
@@ -1,11 +1,10 @@
 <?xml version='1.0'?> <!--*-nxml-*-->
 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
-<!ENTITY % entities SYSTEM "custom-entities.ent" >
-%entities;
-]>
+  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
 
 <!--
+  SPDX-License-Identifier: LGPL-2.1+
+
   This file is part of systemd.
 
   Copyright 2012 Lennart Poettering
     <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
     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>
 
       </varlistentry>
 
       <varlistentry>
-        <term><command>set-locale LOCALE...</command></term>
+        <term><command>set-locale LOCALE</command></term>
 
         <listitem><para>Set the system locale. This takes one or more
         assignments such as "LANG=de_DE.utf8",
       </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 project='die-net'><refentrytitle>mkinitrd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
     </para>
   </refsect1>