swift 13/12/19 10:48:20 Modified: hb-install-config.xml hb-install-system.xml Log: Move locale generation before kernel build, otherwise kernel build will complain about missing/unset locale variables
Revision Changes Path 1.129 xml/htdocs/doc/en/handbook/hb-install-config.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml?rev=1.129&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml?rev=1.129&content-type=text/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml?r1=1.128&r2=1.129 Index: hb-install-config.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v retrieving revision 1.128 retrieving revision 1.129 diff -u -r1.128 -r1.129 --- hb-install-config.xml 18 Dec 2013 10:13:54 -0000 1.128 +++ hb-install-config.xml 19 Dec 2013 10:48:20 -0000 1.129 @@ -4,7 +4,7 @@ <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.128 2013/12/18 10:13:54 swift Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml,v 1.129 2013/12/19 10:48:20 swift Exp $ --> <sections> @@ -14,8 +14,8 @@ proceed. </abstract> -<version>34</version> -<date>2013-12-18</date> +<version>35</version> +<date>2013-12-19</date> <section> <title>Filesystem Information</title> @@ -522,113 +522,6 @@ </body> </subsection> -<subsection> -<title>Configure locales</title> -<body> - -<p> -You will probably only use one or maybe two locales on your system. You have to -specify locales you will need in <path>/etc/locale.gen</path>. -</p> - -<pre caption="Opening /etc/locale.gen"> -# <i>nano -w /etc/locale.gen</i> -</pre> - -<p> -The following locales are an example to get both English (United States) and -German (Germany) with the accompanying character formats (like UTF-8). -</p> - -<pre caption="Specify your locales"> -en_US ISO-8859-1 -en_US.UTF-8 UTF-8 -de_DE ISO-8859-1 -de_DE@euro ISO-8859-15 -</pre> - -<note> -You can select your desired locales in the list given by running <c>locale -a</c>. -</note> - -<warn> -We strongly suggest that you should use at least one UTF-8 locale because some -applications may require it. -</warn> - -<p> -The next step is to run <c>locale-gen</c>. It will generates all the locales you -have specified in the <path>/etc/locale.gen</path> file. -</p> - -<pre caption="Running locale-gen"> -# <i>locale-gen</i> -</pre> - -<p> -You can verify that your selected locales are available by running <c>locale -a</c>. -</p> - -<p> -Once done, you now have the possibility to set the system-wide locale settings. -With <c>eselect locale list</c>, the available targets are displayed: -</p> - -<pre caption="Displaying the available LANG settings"> -# <i>eselect locale list</i> -Available targets for the LANG variable: - [1] C - [2] POSIX - [3] en_US - [4] en_US.iso88591 - [5] en_US.utf8 - [6] de_DE - [7] de_DE.iso88591 - [8] de_DE.iso885915 - [9] de_DE.utf8 - [ ] (free form) -</pre> - -<p> -With <c>eselect locale set <value></c> the correct locale can be set: -</p> - -<pre caption="Setting the LANG variable"> -# <i>eselect locale set 9</i> -</pre> - -<p> -Manually, this can still be accomplished through the -<path>/etc/env.d/02locale</path> file: -</p> - -<pre caption="Setting the default system locale in /etc/env.d/02locale"> -LANG="de_DE.UTF-8" -LC_COLLATE="C" -</pre> - -<p> -Don't forget to reload your environment: -</p> - -<pre caption="Reload shell environment"> -# <i>env-update && source /etc/profile</i> -</pre> - -<p> -We made a full <uri link="https://wiki.gentoo.org/wiki/Localization/HOWTO";>Localization -Guide</uri> to help you through this process. You can also read the detailed -<uri link="https://wiki.gentoo.org/wiki/UTF-8";>UTF-8 article</uri> for very specific -informations to enable UTF-8 on your system. -</p> - -<p test="not(func:keyval('arch')='PPC64')"> -Please continue with <uri link="?part=1&chap=9">Installing Necessary System -Tools</uri>. -</p> - -</body> -</subsection> <subsection test="func:keyval('arch')='PPC64'"> <title>Configuring the Console</title> <body> 1.143 xml/htdocs/doc/en/handbook/hb-install-system.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.143&view=markup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?rev=1.143&content-type=text/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml?r1=1.142&r2=1.143 Index: hb-install-system.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v retrieving revision 1.142 retrieving revision 1.143 diff -u -r1.142 -r1.143 --- hb-install-system.xml 19 Dec 2013 07:59:36 -0000 1.142 +++ hb-install-system.xml 19 Dec 2013 10:48:20 -0000 1.143 @@ -4,7 +4,7 @@ <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.142 2013/12/19 07:59:36 swift Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-system.xml,v 1.143 2013/12/19 10:48:20 swift Exp $ --> <sections> @@ -14,7 +14,7 @@ to progress to that state. </abstract> -<version>34</version> +<version>35</version> <date>2013-12-19</date> <section> @@ -461,4 +461,112 @@ </body> </section> +<section> +<title>Configure locales</title> +<body> + +<p> +You will probably only use one or maybe two locales on your system. You have to +specify locales you will need in <path>/etc/locale.gen</path>. +</p> + +<pre caption="Opening /etc/locale.gen"> +# <i>nano -w /etc/locale.gen</i> +</pre> + +<p> +The following locales are an example to get both English (United States) and +German (Germany) with the accompanying character formats (like UTF-8). +</p> + +<pre caption="Specify your locales"> +en_US ISO-8859-1 +en_US.UTF-8 UTF-8 +de_DE ISO-8859-1 +de_DE@euro ISO-8859-15 +</pre> + +<note> +You can select your desired locales in the list given by running <c>locale -a</c>. +</note> + +<warn> +We strongly suggest that you should use at least one UTF-8 locale because some +applications may require it. +</warn> + +<p> +The next step is to run <c>locale-gen</c>. It will generates all the locales you +have specified in the <path>/etc/locale.gen</path> file. +</p> + +<pre caption="Running locale-gen"> +# <i>locale-gen</i> +</pre> + +<p> +You can verify that your selected locales are available by running <c>locale -a</c>. +</p> + +<p> +Once done, you now have the possibility to set the system-wide locale settings. +With <c>eselect locale list</c>, the available targets are displayed: +</p> + +<pre caption="Displaying the available LANG settings"> +# <i>eselect locale list</i> +Available targets for the LANG variable: + [1] C + [2] POSIX + [3] en_US + [4] en_US.iso88591 + [5] en_US.utf8 + [6] de_DE + [7] de_DE.iso88591 + [8] de_DE.iso885915 + [9] de_DE.utf8 + [ ] (free form) +</pre> + +<p> +With <c>eselect locale set <value></c> the correct locale can be set: +</p> + +<pre caption="Setting the LANG variable"> +# <i>eselect locale set 9</i> +</pre> + +<p> +Manually, this can still be accomplished through the +<path>/etc/env.d/02locale</path> file: +</p> + +<pre caption="Setting the default system locale in /etc/env.d/02locale"> +LANG="de_DE.UTF-8" +LC_COLLATE="C" +</pre> + +<p> +Make sure a locale is set, as you could otherwise get warnings and errors +during kernel builds and other software deployments later in the installation. +</p> + +<p> +Don't forget to reload your environment: +</p> + +<pre caption="Reload shell environment"> +# <i>env-update && source /etc/profile</i> +</pre> + +<p> +We made a full <uri link="https://wiki.gentoo.org/wiki/Localization/HOWTO";>Localization +Guide</uri> to help you through this process. You can also read the detailed +<uri link="https://wiki.gentoo.org/wiki/UTF-8";>UTF-8 article</uri> for very specific +informations to enable UTF-8 on your system. +</p> + +</body> +</section> + </sections>
