Gentoo Archives: gentoo-doc-cvs

From: Lukasz Damentko <rane@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: guide-localization.xml
Date: Mon, 02 Jan 2006 13:54:39
Message-Id: 200601021352.k02Dqvem029488@robin.gentoo.org
1 rane 06/01/02 13:40:18
2
3 Modified: xml/htdocs/doc/en guide-localization.xml
4 Log:
5 adding information about using multiple keyboard layouts (#48820), information about deadkeys, environment updates, international keyboards (#113885) and fixing configuration file for consolefont location to conf.d/consolefont along with init.d/consolefont usage explanation
6
7 Revision Changes Path
8 1.35 +92 -5 xml/htdocs/doc/en/guide-localization.xml
9
10 file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/guide-localization.xml?rev=1.35&content-type=text/x-cvsweb-markup&cvsroot=gentoo
11 plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/guide-localization.xml?rev=1.35&content-type=text/plain&cvsroot=gentoo
12 diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/guide-localization.xml.diff?r1=1.34&r2=1.35&cvsroot=gentoo
13
14 Index: guide-localization.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v
17 retrieving revision 1.34
18 retrieving revision 1.35
19 diff -u -r1.34 -r1.35
20 --- guide-localization.xml 25 Nov 2005 20:43:33 -0000 1.34
21 +++ guide-localization.xml 2 Jan 2006 13:40:18 -0000 1.35
22 @@ -1,5 +1,5 @@
23 <?xml version='1.0' encoding='UTF-8'?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.34 2005/11/25 20:43:33 jkt Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/guide-localization.xml,v 1.35 2006/01/02 13:40:18 rane Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 <guide link="/doc/en/guide-localization.xml">
29 @@ -29,8 +29,8 @@
30 the German doc. Includes configuration for use of the euro currency symbol.
31 </abstract>
32
33 -<version>1.24</version>
34 -<date>2005-11-25</date>
35 +<version>1.25</version>
36 +<date>2006-01-02</date>
37
38 <chapter>
39 <title>Time zone</title>
40 @@ -216,6 +216,28 @@
41 </p>
42
43 <p>
44 +Once you have set the right locale, be sure to update your environment
45 +variables to make your system aware of the change:
46 +</p>
47 +
48 +<pre caption="Update the environment">
49 +# <i>env-update &amp;&amp; source /etc/profile</i>
50 +</pre>
51 +
52 +<p>
53 +After this, you will need to kill your X server by pressing
54 +<c>Ctrl-Alt-Backspace</c>, log out, then log in as user.
55 +</p>
56 +
57 +<p>
58 +Now, verify that the changes have taken effect:
59 +</p>
60 +
61 +<pre caption="Verify env changes">
62 +$ <i>env | grep -i LC_</i>
63 +</pre>
64 +
65 +<p>
66 There is also additional localisation variable called LINGUAS, which affects
67 to localisation files that get installed in gettext-based programs, and decides
68 used localisation for some specific software packages, such as
69 @@ -256,6 +278,19 @@
70 # <i>export LANG="en_US.ISO-8859-15"</i>
71 </pre>
72
73 +<p>
74 +Be sure to update the environment after the change:
75 +</p>
76 +
77 +<pre caption="Update the environment">
78 +# <i>env-update &amp;&amp; source /etc/profile</i>
79 +</pre>
80 +
81 +<p>
82 +After this, you will need to kill your X server by pressing
83 +<c>Ctrl-Alt-Backspace</c>, log out, then log in as user.
84 +</p>
85 +
86 </body>
87 </section>
88 <section>
89 @@ -335,10 +370,46 @@
90 Identifier "Keyboard1"
91 ...
92 Option "XkbLayout" "de"
93 - # Option "XkbVariant" "nodeadkeys"
94 + #Option "XkbModel" "pc105" <comment>## this is for international keyboards.</comment>
95 + # Option "XkbVariant" "nodeadkeys" <comment>## this would be used for xterm input</comment>
96 + ...
97 +</pre>
98 +
99 +<p>
100 +If you have an international keyboard layout, you should set the option
101 +<c>XkbModel</c> to <c>pc102</c> or <c>pc105</c>, as this will allow mapping of the
102 +additional keys specific to your keyboard.
103 +</p>
104 +
105 +<p>
106 +Deadkeys allow you to press keys that will not show immediately but will be
107 +combined with another letter to produce a single character such as é,è,á,à,
108 +etc. Setting <c>XkbVariant</c> to <c>nodeadkeys</c> allows input these special
109 +characters into X terminals.
110 +</p>
111 +
112 +<p>
113 +If you would like to switch between more than one keyboard layout (for example
114 +English and Russian), all you have to do is add a few lines to
115 +<path>xorg.conf</path> that specify the desired layouts and the shortcut
116 +command.
117 +</p>
118 +
119 +<pre caption="Switching between two keyboard layouts">
120 + Section "InputDevice"
121 + Identifier "Keyboard1"
122 ...
123 + Option "XkbLayout" "us,ru"
124 + Option "XkbOptions" "grp:alt_shift_toggle,grp_led:scroll"
125 </pre>
126
127 +<p>
128 +Here, <c>XkbOptions</c> allows you to toggle between keyboard layouts by simply
129 +pressing <c>Alt-Shift</c>. This will also toggle the Scroll Lock light on or
130 +off, thanks to the <c>grp_led:scroll</c> option. This is a handy visual
131 +indicator of which keyboard layout you are using at the moment.
132 +</p>
133 +
134 </body>
135 </section>
136 </chapter>
137 @@ -365,7 +436,7 @@
138 <p>
139 In order to get your console to display the Euro symbol, you
140 will need to set <c>CONSOLEFONT</c> in
141 -<path>/etc/rc.conf</path> to a file found in
142 +<path>/etc/conf.d/consolefont</path> to a file found in
143 <path>/usr/share/consolefonts/</path> (without the
144 <c>.psfu.gz</c>). <c>lat9w-16</c> has the Euro symbol.
145 </p>
146 @@ -374,6 +445,22 @@
147 CONSOLEFONT="lat9w-16"
148 </pre>
149
150 +<p>
151 +You should verify that <c>CONSOLEFONT</c> is in the boot runlevel:
152 +</p>
153 +
154 +<pre caption="Verify the proper runlevel">
155 +# <i>rc-update show | grep -i consolefont</i>
156 +</pre>
157 +
158 +<p>
159 +If no runlevel is displayed for <c>CONSOLEFONT</c>, then add it to the proper level:
160 +</p>
161 +
162 +<pre caption="Add consolefont to boot">
163 +# <i>rc-update add consolefont boot</i>
164 +</pre>
165 +
166 </body>
167 </section>
168 </chapter>
169
170
171
172 --
173 gentoo-doc-cvs@g.o mailing list