Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed
  • BOOK/bootscripts/common/locale.xml

    r5b3e31fd r68a8a9f  
    1111
    1212  <indexterm zone="ch-scripts-locale">
    13     <primary sortas="e-/etc/profile">/etc/profile</primary>
     13    <primary sortas="e-/etc/locale.conf">/etc/locale.conf</primary>
    1414  </indexterm>
    1515
    16   <para>The base <filename>/etc/profile</filename> below sets some
    17   environment variables necessary for native language support. Setting
    18   them properly results in:</para>
     16  <para>The <filename>/etc/locale.conf</filename> below sets some environment
     17  variables necessary for native language support. Setting them properly
     18  results in:</para>
    1919
    2020  <itemizedlist>
     
    2323    </listitem>
    2424    <listitem>
    25       <para>Correct classification of characters into letters, digits and
    26       other classes. This is necessary for <command>bash</command> to
    27       properly accept non-ASCII characters in command lines in non-English
    28       locales</para>
     25      <para>Correct classification of characters into letters, digits and other
     26      classes. This is necessary for <command>bash</command> to properly accept
     27      non-ASCII characters in command lines in non-English locales</para>
    2928    </listitem>
    3029    <listitem>
     
    3938  </itemizedlist>
    4039
    41   <para>This script also sets the <envar>INPUTRC</envar> environment variable
    42   that makes Bash and Readline use the <filename>/etc/inputrc</filename> file
    43   created earlier.</para>
    44 
    4540  <para>Replace <replaceable>[ll]</replaceable> below with the
    4641  two-letter code for the desired language (e.g., <quote>en</quote>) and
    4742  <replaceable>[CC]</replaceable> with the two-letter code for the
    48   appropriate country (e.g., <quote>GB</quote>).
     43  appropriate country (e.g., <quote>GB</quote> or <quote>US</quote>).
    4944  <replaceable>[charmap]</replaceable> should be replaced with the
    50   canonical charmap for your chosen locale.</para>
     45  canonical charmap for your chosen locale. Optional modifiers such as
     46  <quote>@euro</quote> may also be present.</para>
    5147
    5248  <para>The list of all locales supported by Glibc can be obtained by running
     
    7167
    7268  <para>This results in a final locale setting of <quote>en_US.UTF-8</quote>.
    73   It is important that the locale found using the heuristic above is tested prior
    74   to it being added to the Bash startup files:</para>
     69  It is important that the locale found using the heuristic above is tested
     70  prior to it being added to <filename>/etc/locale.conf</filename>:</para>
    7571
    7672<screen role="nodump"><userinput>LC_ALL=[locale name] locale territory
     
    108104
    109105  <para>Other packages can also function incorrectly (but may not necessarily
    110   display any error messages) if the locale name does not meet their expectations.
    111   In those cases, investigating how other Linux distributions support your locale
    112   might provide some useful information.</para>
     106  display any error messages) if the locale name does not meet their
     107  expectations. In those cases, investigating how other Linux distributions
     108  support your locale might provide some useful information.</para>
    113109
    114110  <para>Once the proper locale settings have been determined, create the
    115   <filename>/etc/profile</filename> file:</para>
     111  <filename>/etc/locale.conf</filename> file:</para>
    116112
    117 <screen><userinput>cat &gt; /etc/profile &lt;&lt; "EOF"
    118 <literal># Begin /etc/profile
     113<screen><userinput>cat &gt; /etc/locale.conf &lt;&lt; "EOF"
     114<literal># Begin /etc/locale.conf
    119115
    120 export LANG=<replaceable>[ll]</replaceable>_<replaceable>[CC]</replaceable>.<replaceable>[charmap]</replaceable>
    121 export INPUTRC=/etc/inputrc
     116LANG=<replaceable>[ll]</replaceable>_<replaceable>[CC]</replaceable>.<replaceable>[charmap]</replaceable><replaceable>[@modifiers]</replaceable>
    122117
    123 # End /etc/profile</literal>
     118# End /etc/locale.conf</literal>
    124119EOF</userinput></screen>
    125120
     121  <para>Note that you can modify <filename>/etc/locale.conf</filename> with
     122  Systemd <command>localectl</command> utility. To use
     123  <command>localectl</command> for the example above, run:</para>
     124
     125<screen role="nodump"><userinput>localectl set-locale LANG="<replaceable>[ll]_[CC][charmap][@modifiers]</replaceable>"</userinput></screen>
     126
     127  <para>You can also specify other language specific environment variables such
     128  as <envar>LANG</envar>, <envar>LC_CTYPE</envar>, <envar>LC_NUMERIC</envar> or
     129  any other environment variable from <command>locale</command> output. Just
     130  separate them with a space. An example where <envar>LANG</envar> is set as
     131  en_US.UTF-8 but <envar>LC_CTYPE</envar> is set as just en_US is:</para>
     132
     133<screen role="nodump"><userinput>localectl set-locale LANG="en_US.UTF-8" LC_CTYPE="en_US"</userinput></screen>
     134
     135  <note><para>Please note that <command>localectl</command> command can
     136  be used  only on a system booted with Systemd.</para></note>
    126137  <para>Setting the keyboard layout, screen font, and locale-related
    127138  environment variables are the only internationalization steps needed to
Note: See TracChangeset for help on using the changeset viewer.