CVS update of carob/doc (locales)

    Date: Wednesday, August 15, 2007 @ 16:42:11
  Author: marc
    Path: /cvsroot/carob/carob/doc

Modified: locales (1.3 -> 1.4)

Fixed Ubuntu explanation (belocs vs libc locales)


---------+
 locales |   22 ++++++++++++++--------
 1 files changed, 14 insertions(+), 8 deletions(-)


Index: carob/doc/locales
diff -u carob/doc/locales:1.3 carob/doc/locales:1.4
--- carob/doc/locales:1.3       Wed Jan 31 09:06:02 2007
+++ carob/doc/locales   Wed Aug 15 16:42:11 2007
@@ -1,7 +1,7 @@
 Why locales
 ~~~~~~~~~~~
 
-Carob is using locales for two reasons:
+Carob is using locales for two needs:
 
 1. To encode output (mainly: log messages) according to the user
    preference, just like any well-behaved application. See
@@ -47,21 +47,27 @@
 Build/Install a new locale
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-* "Old" debian-based distros
+- "Old" debian-based distros
 
 # dpkg-reconfigure locales
 
 
-* "New" debian-based distros
+- Ubuntu
 
-The above command does only a rebuild; no re-configuration.
-Configuration has now moved to the non-interactive "locale-gen" tool.
+Starting from Dapper, Ubuntu dropped the locales from GNU libc and
+is using belocs locales instead for more flexibility
+ <https://wiki.ubuntu.com/LocalesThatDontSuck>
+The configuration interface of "dpkg-reconfigure locales" is removed
+and NOT replaced. Installing a language pack automatically generates
+"all" locales for this language. But "all" is a small lie: they
+generate only UTF-8 locales. For non-UTF-8 locales, use locale-gen like
+this:
 
-# locale-gen <locale from /usr/share/i18n/SUPPORTED>
+# locale-gen <your locale from /usr/share/i18n/SUPPORTED>
 For instance: # locale-gen fr_FR@euro
 
-For more details check man locale-gen and
-http://ubuntuguide.org/wiki/Ubuntu_Edgy#How_to_add_locales_to_Ubuntu_the_command_line_way
+"man locale-gen" has all the details (especially the "FILES" section)
+
 
 * Check the "FAQ Solaris locales"