Changeset 2164942

Timestamp:

Feb 13, 2011, 2:37:46 PM (14 years ago)

Author:

Joe Ciccone <jciccone@…>

Branches:

clfs-3.0.0-systemd, clfs-3.0.0-sysvinit, master, systemd, sysvinit

Children:

c58eb217

Parents:

40fbd36

Message:

Rewrote the page about configuring the locales.

File:

• BOOK/bootscripts/common/locale.xml (modified) (4 diffs)

BOOK/bootscripts/common/locale.xml

@@ -11 +11 @@
 
   <indexterm zone="ch-scripts-locale">
-    <primary sortas="e-/etc/profile">/etc/profile</primary>
+    <primary sortas="e-/etc/locale.conf">/etc/locale.conf</primary>
   </indexterm>
 
-  <para>The base <filename>/etc/profile</filename> below sets some
-  environment variables necessary for native language support. Setting
-  them properly results in:</para>
+  <para>The file <filename>/etc/locale.conf</filename> file configures
+  system-wide locale settings. The basic file format of locale.conf is a
+  newline-separated list of variable assignments. It is possible to source this
+  configuration file from shell scripts, but it should never contain any shell
+  script features beyond variable assignments. The
+  <filename>locale.conf</filename> man page contains information about the
+  function of this file. Setting up this file properly results in:</para>
 
   <itemizedlist>
@@ -39 +43 @@
   </itemizedlist>
 
-  <para>This script also sets the <envar>INPUTRC</envar> environment variable
-  that makes Bash and Readline use the <filename>/etc/inputrc</filename> file
-  created earlier.</para>
-
   <para>Replace <replaceable>[ll]</replaceable> below with the
   two-letter code for the desired language (e.g., <quote>en</quote>) and
   <replaceable>[CC]</replaceable> with the two-letter code for the
-  appropriate country (e.g., <quote>GB</quote>).
+  appropriate country (e.g., <quote>GB</quote> or <quote>US</quote>).
   <replaceable>[charmap]</replaceable> should be replaced with the
   canonical charmap for your chosen locale.</para>
@@ -72 +72 @@
   <para>This results in a final locale setting of <quote>en_US.UTF-8</quote>.
   It is important that the locale found using the heuristic above is tested prior
-  to it being added to the Bash startup files:</para>
+  to it being added to <filename>/etc/locale.conf</filename>:</para>
 
 <screen role="nodump"><userinput>LC_ALL=[locale name] locale country
@@ -113 +113 @@
 
   <para>Once the proper locale settings have been determined, create the
-  <filename>/etc/profile</filename> file:</para>
+  <filename>/etc/locale.conf</filename> file:</para>
 
-<screen><userinput>cat &gt; /etc/profile &lt;&lt; "EOF"
-<literal># Begin /etc/profile
+<screen><userinput>cat &gt; /etc/locale.conf &lt;&lt; "EOF"
+<literal># Begin /etc/locale.conf
 
-export LANG=<replaceable>[ll]</replaceable>_<replaceable>[CC]</replaceable>.<replaceable>[charmap]</replaceable>
-export INPUTRC=/etc/inputrc
+LANG=<replaceable>[ll]</replaceable>_<replaceable>[CC]</replaceable>.<replaceable>[charmap]</replaceable>
 
-# End /etc/profile</literal>
+# End /etc/locale.conf</literal>
 EOF</userinput></screen>