neysx       06/05/25 16:22:37

  Modified:             guide-localization.xml
  Log:
  #134032 Mention system locale vs user locale

Revision  Changes    Path
1.39                 xml/htdocs/doc/en/guide-localization.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/guide-localization.xml?rev=1.39&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/guide-localization.xml?rev=1.39&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/guide-localization.xml.diff?r1=1.38&r2=1.39&cvsroot=gentoo

Index: guide-localization.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- guide-localization.xml	15 May 2006 12:32:31 -0000	1.38
+++ guide-localization.xml	25 May 2006 16:22:37 -0000	1.39
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='UTF-8'?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.38 2006/05/15 12:32:31 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.39 2006/05/25 16:22:37 neysx Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
 <guide link="/doc/en/guide-localization.xml">
@@ -29,8 +29,8 @@
 the German doc. Includes configuration for use of the euro currency symbol.
 </abstract>
 
-<version>1.28</version>
-<date>2006-05-15</date>
+<version>1.29</version>
+<date>2006-05-25</date>
 
 <chapter>
 <title>Time zone</title>
@@ -45,7 +45,7 @@
 indicate the expected zones. For instance, <path>GMT-8</path> is in fact GMT+8.
 </p>
 
-<pre caption="setting the timezone">
+<pre caption="Setting the timezone">
 # <i>cp /usr/share/zoneinfo/Europe/Berlin /etc/localtime</i>
 # <i>date</i>
 Sun Feb 16 08:26:44 CET 2003
@@ -198,20 +198,36 @@
 the environment variable manually from command line:
 </p>
 
-<pre caption="setting the German locale">
+<pre caption="Setting the user locale in ~/.bashrc">
 export LANG="de_DE@euro"
 </pre>
 
 <note>
 Append <c>@euro</c> to your locale if you want to use the Euro
-currency symbol (&#8364;)
+currency symbol (€)
 </note>
 
 <p>
+It is also possible to set a system-wide locale for all users and programs:
+</p>
+
+<pre caption="Setting the default system locale in /etc/env.d/02locale">
+LC_ALL="de_DE@euro"
+LANG="de_DE@euro"
+</pre>
+
+<p>
+A common practice is to use only per user locale settings and leave the
+default system locale unset. In this case system locale defaults to a
+special value <c>"C"</c>, which for historical reasons maps to the English
+locale.
+</p>
+
+<p>
 For message based localization to work in programs that support it, you will
 probably need to have programs compiled with the <c>nls</c> (Native language
 support) USE flag set. Most of the programs using nls also need the gettext
-library to extract and use localized messages. Of course, Gentoo's Portage will
+library to extract and use localized messages. Of course, Portage will
 automatically install it when needed.
 </p>
 
@@ -221,7 +237,11 @@
 </p>
 
 <pre caption="Update the environment">
+<comment>(For system-wide default locale:)</comment>
 # <i>env-update &amp;&amp; source /etc/profile</i>
+
+<comment>(For user-specific locale:</comment>
+$ <i>source ~/.bashrc</i>
 </pre>
 
 <p>
@@ -246,7 +266,7 @@
 place to set it is <path>/etc/make.conf</path>:
 </p>
 
-<pre caption="setting LINGUAS in make.conf">
+<pre caption="Setting LINGUAS in make.conf">
 # <i>nano -w /etc/make.conf</i>
 <comment>(Add in the LINGUAS variable. For instance, 
 for German, Finnish and English:)</comment>
@@ -344,7 +364,7 @@
 to decide which one fits your needs best.
 </p>
 
-<pre caption="setting the console keymap">
+<pre caption="Setting the console keymap">
 KEYMAP="de"
 KEYMAP="de-latin1"
 KEYMAP="de-latin1-nodeadkeys"
@@ -365,7 +385,7 @@
 option.
 </p>
 
-<pre caption="setting the X keymap">
+<pre caption="Setting the X keymap">
  Section "InputDevice"
      Identifier  "Keyboard1"
      ...
@@ -441,7 +461,7 @@
 <c>.psfu.gz</c>).  <c>lat9w-16</c> has the Euro symbol.
 </p>
 
-<pre caption="setting the console font">
+<pre caption="Setting the console font">
 CONSOLEFONT="lat9w-16"
 </pre>
 
@@ -479,7 +499,7 @@
 in <c>iso8859-15</c> instead of <c>iso8859-1</c>.
 </p>
 
-<pre caption="setting default X fonts">
+<pre caption="Setting default X fonts">
 fixed        -misc-fixed-medium-r-semicondensed--13-120-75-75-c-60-iso8859-15
 variable     -*-helvetica-bold-r-normal-*-*-120-*-*-*-*-iso8859-15
 </pre>
@@ -497,7 +517,7 @@
 instance:
 </p>
 
-<pre caption="setting fonts for xterm">
+<pre caption="Setting fonts for xterm">
 <comment>(in your home directory)</comment>
 $ <i>echo 'XTerm*font: fixed' >> .Xresources </i>
 $ <i>xrdb -merge .Xresources</i>
@@ -524,7 +544,7 @@
 </p>
 
 <pre caption="setting the font for xemacs">
-(define-key global-map '(EuroSign) '[&#8364;])
+(define-key global-map '(EuroSign) '[€])
 </pre>
 
 <note>



-- 
gentoo-doc-cvs@gentoo.org mailing list