summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@open-infrastructure.net>2017-04-07 04:23:31 +0000
committerDaniel Baumann <daniel.baumann@open-infrastructure.net>2017-04-07 10:29:10 +0000
commit88e4c9dbdfd26bb3184fed820c7f91e918f1266f (patch)
tree32fa83cac0eb865a898478870084df1d7bdd014c
parentCorrecting filename of bash config file. (diff)
downloadlocales-c.utf-8-88e4c9dbdfd26bb3184fed820c7f91e918f1266f.tar.xz
locales-c.utf-8-88e4c9dbdfd26bb3184fed820c7f91e918f1266f.zip
Rewriting and updating texts in manpage.
Signed-off-by: Daniel Baumann <daniel.baumann@open-infrastructure.net>
-rw-r--r--share/man/locales-c.utf-8.7.txt95
1 files changed, 70 insertions, 25 deletions
diff --git a/share/man/locales-c.utf-8.7.txt b/share/man/locales-c.utf-8.7.txt
index 57ad2d8..d165e4d 100644
--- a/share/man/locales-c.utf-8.7.txt
+++ b/share/man/locales-c.utf-8.7.txt
@@ -30,8 +30,8 @@ locales-c.utf-8 - Circumvent Debian locales packages using C.UTF-8
DESCRIPTION
-----------
"[A] locale is a set of parameters that defines the user's language, region and
-any special variant preferences that the user wants to see in their user
-interface."::
+ any special variant preferences that the user wants to see in their user
+ interface."::
-- Wikipedia (https://en.wikipedia.org/wiki/Locale_(computer_software))
locale-c.utf-8 provides the system integration to use C.UTF-8 within Debian
@@ -55,11 +55,15 @@ SOURCE
2. git clone https://sources.open-infrastructure.net/software/locales-c.utf-8
3. cd locales-c.utf-8 && sudo make install
+DEBIAN 10 (BUSTER) AND NEWER
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ * sudo apt install locales-c.utf-8
+
DEVELOPMENT
-----------
-Bug reports, feature requests, help, patches, support and everything else
-are welcome on the Open Infrastructure Software Mailing List:
+Bug reports, feature requests, help, patches, support and everything else are
+welcome on the Open Infrastructure Software Mailing List:
* https://lists.open-infrastructure.net/listinfo/software
@@ -75,36 +79,77 @@ Debian specific bugs can also be reported in the Debian Bug Tracking System:
RATIONAL
--------
+Introduction
+~~~~~~~~~~~~
+On Debian based systems the locales and locales-all packages contain the
+localization files (called locale, or locales) for all currently supported
+regions and languages.
+
+The locales and locales-all packages also contain configuration files to define
+a default locale for a system. Other packages are relying on these settings in
+order to work properly.
+
+If the locales or the configuration of the default locale is missing the
+automatic fallback of libc is used, which currently is C and not C.UTF-8:
+
+ * The C locale is the standard locale, it implements the ISO C standard and
+ basically is a en_US locale with a metric system and 24 hours time format.
+
+ * The C.UTF-8 is a Unicode-aware version of the C locale.
+
Problem
~~~~~~~
-On Debian based system the locales or locales-all package provide not only
-the localization files itself but also some system configuration
+Debian based systems expect a UTF-8 capable locale. Some packages behave
+differently when being run under a non-UTF-8 locale, such as:
-If any of this is missing, the fallback local of libc is used (C and not
-C.UTF-8). Therefore, when falling back to a non-UTF-8 locale some packages
-behave differently, such as:
+ * programs may show warnings on the command line
+ * programs may fail to start
- * showing warnings on the command line
- * failing to start
+Additionally some packages in Debian strictly depend on the locales or
+locales-all package eventhough only they require a proper UTF-8 locale to be
+used.
-Additionally some packages in Debian depend on locales or locales-all
-eventhough C.UTF-8 from libc-bin (which is marked as an essential package
-and thus the C.UTF-8 locale is always present on any Debian based system)
-would be enough.
+The C.UTF-8 locale is included in the libc-bin package which is a package marked
+essential and thus always present on any Debian based system.
-Use Case
+Solution
~~~~~~~~
-On minimal systems such as servers and containers one prefers to use
-the C.UTF-8 locale instead of en_US.UTF-8. This can save up to 125MB
-(locales-all) or at least save the system from the reconfigure and
-preseed handling on upgrades (locales).
+The locale-c.utf-8 package provides the necessary glue on the system level
+(configuration files) as well as the on the package manager level
+(conflicts/breaks/provides on locales and locales-all) to allow using C.UTF-8 as
+the default locale by not breaking any other packages assumptions.
-Solution
+Use Case
~~~~~~~~
-The locale-c.utf-8 package provides the necessary glue on the system
-level (configuration files) as well as the on the package manager level
-(conflicts/breaks/provides on locales and locales-all) to allow using C.UTF-8
-as the default locale by not breaking any other packages assumptions.
+On minimal systems such as servers and containers system administrators often
+prefer to use the C.UTF-8 locale instead of e.g. en_US.UTF-8:
+
+ * Compared to locales-all this saves approximatly 125MB of disk space.
+ * Compared to locales this saves only about 10MB, but avoids the
+ reconfiguration handling on upgrades.
+
+
+FILES
+-----
+The following files are used:
+
+*/etc/profile.d/zz-locale-c.utf-8.sh*::
+ bash configuration file.
+
+*/etc/default/locales*::
+ locales configuration file.
+
+
+SEE ALSO
+--------
+locale(1),
+locale(7).
+
+
+LINKS
+-----
+*The GNU C Library: Locales and Internationalization*::
+ https://www.gnu.org/software/libc/manual/html_node/Locales.html
AUTHORS