1 |
swift 13/12/19 10:48:20 |
2 |
|
3 |
Modified: hb-install-config.xml hb-install-system.xml |
4 |
Log: |
5 |
Move locale generation before kernel build, otherwise kernel build will complain about missing/unset locale variables |
6 |
|
7 |
Revision Changes Path |
8 |
1.129 xml/htdocs/doc/en/handbook/hb-install-config.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml?rev=1.129&view=markup |
11 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml?rev=1.129&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml?r1=1.128&r2=1.129 |
13 |
|
14 |
Index: hb-install-config.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v |
17 |
retrieving revision 1.128 |
18 |
retrieving revision 1.129 |
19 |
diff -u -r1.128 -r1.129 |
20 |
--- hb-install-config.xml 18 Dec 2013 10:13:54 -0000 1.128 |
21 |
+++ hb-install-config.xml 19 Dec 2013 10:48:20 -0000 1.129 |
22 |
@@ -4,7 +4,7 @@ |
23 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
24 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
25 |
|
26 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.128 2013/12/18 10:13:54 swift Exp $ --> |
27 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.129 2013/12/19 10:48:20 swift Exp $ --> |
28 |
|
29 |
<sections> |
30 |
|
31 |
@@ -14,8 +14,8 @@ |
32 |
proceed. |
33 |
</abstract> |
34 |
|
35 |
-<version>34</version> |
36 |
-<date>2013-12-18</date> |
37 |
+<version>35</version> |
38 |
+<date>2013-12-19</date> |
39 |
|
40 |
<section> |
41 |
<title>Filesystem Information</title> |
42 |
@@ -522,113 +522,6 @@ |
43 |
</body> |
44 |
</subsection> |
45 |
|
46 |
-<subsection> |
47 |
-<title>Configure locales</title> |
48 |
-<body> |
49 |
- |
50 |
-<p> |
51 |
-You will probably only use one or maybe two locales on your system. You have to |
52 |
-specify locales you will need in <path>/etc/locale.gen</path>. |
53 |
-</p> |
54 |
- |
55 |
-<pre caption="Opening /etc/locale.gen"> |
56 |
-# <i>nano -w /etc/locale.gen</i> |
57 |
-</pre> |
58 |
- |
59 |
-<p> |
60 |
-The following locales are an example to get both English (United States) and |
61 |
-German (Germany) with the accompanying character formats (like UTF-8). |
62 |
-</p> |
63 |
- |
64 |
-<pre caption="Specify your locales"> |
65 |
-en_US ISO-8859-1 |
66 |
-en_US.UTF-8 UTF-8 |
67 |
-de_DE ISO-8859-1 |
68 |
-de_DE@euro ISO-8859-15 |
69 |
-</pre> |
70 |
- |
71 |
-<note> |
72 |
-You can select your desired locales in the list given by running <c>locale -a</c>. |
73 |
-</note> |
74 |
- |
75 |
-<warn> |
76 |
-We strongly suggest that you should use at least one UTF-8 locale because some |
77 |
-applications may require it. |
78 |
-</warn> |
79 |
- |
80 |
-<p> |
81 |
-The next step is to run <c>locale-gen</c>. It will generates all the locales you |
82 |
-have specified in the <path>/etc/locale.gen</path> file. |
83 |
-</p> |
84 |
- |
85 |
-<pre caption="Running locale-gen"> |
86 |
-# <i>locale-gen</i> |
87 |
-</pre> |
88 |
- |
89 |
-<p> |
90 |
-You can verify that your selected locales are available by running <c>locale -a</c>. |
91 |
-</p> |
92 |
- |
93 |
-<p> |
94 |
-Once done, you now have the possibility to set the system-wide locale settings. |
95 |
-With <c>eselect locale list</c>, the available targets are displayed: |
96 |
-</p> |
97 |
- |
98 |
-<pre caption="Displaying the available LANG settings"> |
99 |
-# <i>eselect locale list</i> |
100 |
-Available targets for the LANG variable: |
101 |
- [1] C |
102 |
- [2] POSIX |
103 |
- [3] en_US |
104 |
- [4] en_US.iso88591 |
105 |
- [5] en_US.utf8 |
106 |
- [6] de_DE |
107 |
- [7] de_DE.iso88591 |
108 |
- [8] de_DE.iso885915 |
109 |
- [9] de_DE.utf8 |
110 |
- [ ] (free form) |
111 |
-</pre> |
112 |
- |
113 |
-<p> |
114 |
-With <c>eselect locale set <value></c> the correct locale can be set: |
115 |
-</p> |
116 |
- |
117 |
-<pre caption="Setting the LANG variable"> |
118 |
-# <i>eselect locale set 9</i> |
119 |
-</pre> |
120 |
- |
121 |
-<p> |
122 |
-Manually, this can still be accomplished through the |
123 |
-<path>/etc/env.d/02locale</path> file: |
124 |
-</p> |
125 |
- |
126 |
-<pre caption="Setting the default system locale in /etc/env.d/02locale"> |
127 |
-LANG="de_DE.UTF-8" |
128 |
-LC_COLLATE="C" |
129 |
-</pre> |
130 |
- |
131 |
-<p> |
132 |
-Don't forget to reload your environment: |
133 |
-</p> |
134 |
- |
135 |
-<pre caption="Reload shell environment"> |
136 |
-# <i>env-update && source /etc/profile</i> |
137 |
-</pre> |
138 |
- |
139 |
-<p> |
140 |
-We made a full <uri link="https://wiki.gentoo.org/wiki/Localization/HOWTO">Localization |
141 |
-Guide</uri> to help you through this process. You can also read the detailed |
142 |
-<uri link="https://wiki.gentoo.org/wiki/UTF-8">UTF-8 article</uri> for very specific |
143 |
-informations to enable UTF-8 on your system. |
144 |
-</p> |
145 |
- |
146 |
-<p test="not(func:keyval('arch')='PPC64')"> |
147 |
-Please continue with <uri link="?part=1&chap=9">Installing Necessary System |
148 |
-Tools</uri>. |
149 |
-</p> |
150 |
- |
151 |
-</body> |
152 |
-</subsection> |
153 |
<subsection test="func:keyval('arch')='PPC64'"> |
154 |
<title>Configuring the Console</title> |
155 |
<body> |
156 |
|
157 |
|
158 |
|
159 |
1.143 xml/htdocs/doc/en/handbook/hb-install-system.xml |
160 |
|
161 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.143&view=markup |
162 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.143&content-type=text/plain |
163 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?r1=1.142&r2=1.143 |
164 |
|
165 |
Index: hb-install-system.xml |
166 |
=================================================================== |
167 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v |
168 |
retrieving revision 1.142 |
169 |
retrieving revision 1.143 |
170 |
diff -u -r1.142 -r1.143 |
171 |
--- hb-install-system.xml 19 Dec 2013 07:59:36 -0000 1.142 |
172 |
+++ hb-install-system.xml 19 Dec 2013 10:48:20 -0000 1.143 |
173 |
@@ -4,7 +4,7 @@ |
174 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
175 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
176 |
|
177 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.142 2013/12/19 07:59:36 swift Exp $ --> |
178 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.143 2013/12/19 10:48:20 swift Exp $ --> |
179 |
|
180 |
<sections> |
181 |
|
182 |
@@ -14,7 +14,7 @@ |
183 |
to progress to that state. |
184 |
</abstract> |
185 |
|
186 |
-<version>34</version> |
187 |
+<version>35</version> |
188 |
<date>2013-12-19</date> |
189 |
|
190 |
<section> |
191 |
@@ -461,4 +461,112 @@ |
192 |
</body> |
193 |
</section> |
194 |
|
195 |
+<section> |
196 |
+<title>Configure locales</title> |
197 |
+<body> |
198 |
+ |
199 |
+<p> |
200 |
+You will probably only use one or maybe two locales on your system. You have to |
201 |
+specify locales you will need in <path>/etc/locale.gen</path>. |
202 |
+</p> |
203 |
+ |
204 |
+<pre caption="Opening /etc/locale.gen"> |
205 |
+# <i>nano -w /etc/locale.gen</i> |
206 |
+</pre> |
207 |
+ |
208 |
+<p> |
209 |
+The following locales are an example to get both English (United States) and |
210 |
+German (Germany) with the accompanying character formats (like UTF-8). |
211 |
+</p> |
212 |
+ |
213 |
+<pre caption="Specify your locales"> |
214 |
+en_US ISO-8859-1 |
215 |
+en_US.UTF-8 UTF-8 |
216 |
+de_DE ISO-8859-1 |
217 |
+de_DE@euro ISO-8859-15 |
218 |
+</pre> |
219 |
+ |
220 |
+<note> |
221 |
+You can select your desired locales in the list given by running <c>locale -a</c>. |
222 |
+</note> |
223 |
+ |
224 |
+<warn> |
225 |
+We strongly suggest that you should use at least one UTF-8 locale because some |
226 |
+applications may require it. |
227 |
+</warn> |
228 |
+ |
229 |
+<p> |
230 |
+The next step is to run <c>locale-gen</c>. It will generates all the locales you |
231 |
+have specified in the <path>/etc/locale.gen</path> file. |
232 |
+</p> |
233 |
+ |
234 |
+<pre caption="Running locale-gen"> |
235 |
+# <i>locale-gen</i> |
236 |
+</pre> |
237 |
+ |
238 |
+<p> |
239 |
+You can verify that your selected locales are available by running <c>locale -a</c>. |
240 |
+</p> |
241 |
+ |
242 |
+<p> |
243 |
+Once done, you now have the possibility to set the system-wide locale settings. |
244 |
+With <c>eselect locale list</c>, the available targets are displayed: |
245 |
+</p> |
246 |
+ |
247 |
+<pre caption="Displaying the available LANG settings"> |
248 |
+# <i>eselect locale list</i> |
249 |
+Available targets for the LANG variable: |
250 |
+ [1] C |
251 |
+ [2] POSIX |
252 |
+ [3] en_US |
253 |
+ [4] en_US.iso88591 |
254 |
+ [5] en_US.utf8 |
255 |
+ [6] de_DE |
256 |
+ [7] de_DE.iso88591 |
257 |
+ [8] de_DE.iso885915 |
258 |
+ [9] de_DE.utf8 |
259 |
+ [ ] (free form) |
260 |
+</pre> |
261 |
+ |
262 |
+<p> |
263 |
+With <c>eselect locale set <value></c> the correct locale can be set: |
264 |
+</p> |
265 |
+ |
266 |
+<pre caption="Setting the LANG variable"> |
267 |
+# <i>eselect locale set 9</i> |
268 |
+</pre> |
269 |
+ |
270 |
+<p> |
271 |
+Manually, this can still be accomplished through the |
272 |
+<path>/etc/env.d/02locale</path> file: |
273 |
+</p> |
274 |
+ |
275 |
+<pre caption="Setting the default system locale in /etc/env.d/02locale"> |
276 |
+LANG="de_DE.UTF-8" |
277 |
+LC_COLLATE="C" |
278 |
+</pre> |
279 |
+ |
280 |
+<p> |
281 |
+Make sure a locale is set, as you could otherwise get warnings and errors |
282 |
+during kernel builds and other software deployments later in the installation. |
283 |
+</p> |
284 |
+ |
285 |
+<p> |
286 |
+Don't forget to reload your environment: |
287 |
+</p> |
288 |
+ |
289 |
+<pre caption="Reload shell environment"> |
290 |
+# <i>env-update && source /etc/profile</i> |
291 |
+</pre> |
292 |
+ |
293 |
+<p> |
294 |
+We made a full <uri link="https://wiki.gentoo.org/wiki/Localization/HOWTO">Localization |
295 |
+Guide</uri> to help you through this process. You can also read the detailed |
296 |
+<uri link="https://wiki.gentoo.org/wiki/UTF-8">UTF-8 article</uri> for very specific |
297 |
+informations to enable UTF-8 on your system. |
298 |
+</p> |
299 |
+ |
300 |
+</body> |
301 |
+</section> |
302 |
+ |
303 |
</sections> |