Gentoo Archives: gentoo-doc-cvs

From: "Sven Vermeulen (swift)" <swift@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: hb-install-config.xml hb-install-system.xml
Date: Thu, 19 Dec 2013 10:48:25
Message-Id: 20131219104820.ABC852004B@flycatcher.gentoo.org
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 &lt;value&gt;</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 &amp;&amp; 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&amp;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 &lt;value&gt;</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 &amp;&amp; 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>