[gentoo-commits] gentoo commit in src/patchsets/glibc/extra/locale: locale.gen locale.gen.5

[Mike Frysinger (vapier)]

vapier      15/08/29 04:32:29

  Modified:             locale.gen locale.gen.5
  Log:
  improve documentation greatly #235555

Revision  Changes    Path
1.2                  src/patchsets/glibc/extra/locale/locale.gen

file : http://sources.gentoo.org/viewvc.cgi/gentoo/src/patchsets/glibc/extra/locale/locale.gen?rev=1.2&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/src/patchsets/glibc/extra/locale/locale.gen?rev=1.2&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/src/patchsets/glibc/extra/locale/locale.gen?r1=1.1&r2=1.2

Index: locale.gen
===================================================================
RCS file: /var/cvsroot/gentoo/src/patchsets/glibc/extra/locale/locale.gen,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- locale.gen	17 Apr 2006 08:10:24 -0000	1.1
+++ locale.gen	29 Aug 2015 04:32:29 -0000	1.2
@@ -1,10 +1,15 @@
-# /etc/locale.gen: list all of the locales you want to have on your system
+# /etc/locale.gen: list all of the locales you want to have on your system.
+# See the locale.gen(5) man page for more details.
 #
 # The format of each line:
-# <locale> <charmap>
+# <locale name> <charset>
 #
-# Where <locale> is a locale located in /usr/share/i18n/locales/ and
-# where <charmap> is a charmap located in /usr/share/i18n/charmaps/.
+# Where <locale name> starts with a name as found in /usr/share/i18n/locales/.
+# It must be unique in the file as it is used as the key to locale variables.
+# For non-default encodings, the <charset> is typically appended.
+#
+# Where <charset> is a charset located in /usr/share/i18n/charmaps/ (sans any
+# suffix like ".gz").
 #
 # All blank lines and lines starting with # are ignored.
 #



1.4                  src/patchsets/glibc/extra/locale/locale.gen.5

file : http://sources.gentoo.org/viewvc.cgi/gentoo/src/patchsets/glibc/extra/locale/locale.gen.5?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/src/patchsets/glibc/extra/locale/locale.gen.5?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/src/patchsets/glibc/extra/locale/locale.gen.5?r1=1.3&r2=1.4

Index: locale.gen.5
===================================================================
RCS file: /var/cvsroot/gentoo/src/patchsets/glibc/extra/locale/locale.gen.5,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- locale.gen.5	29 Dec 2007 21:34:46 -0000	1.3
+++ locale.gen.5	29 Aug 2015 04:32:29 -0000	1.4
@@ -23,12 +23,18 @@
 
 Each line is of the form:
 
-<locale> <charset>
+<locale name> <charset>
 
-where <locale> is one of the locales given in 
-.B /usr/share/i18n/locales
-and <charset> is one of the character sets listed in 
+Where <locale name> starts with a name as found in
+.BR /usr/share/i18n/locales/ .
+It must be unique in the file as it is used as the key to locale variables
+(e.g. when you do `export LANG="<locale name>"`).  For default encodings,
+the <charset> is typically omitted, else it is appended with a "." separator.
+
+Where <charset> is one of the character sets listed in
 .B /usr/share/i18n/charmaps
+(sans any suffix like ".gz").  It should use the same naming conventions too --
+all caps, and dashes/underscores included.  e.g. Use "UTF-8", not "utf8".
 
 The
 .B locale-gen
@@ -36,14 +42,36 @@
 \fB/usr/lib/locale\fP.
 
 Comments start with the hash mark # and may only be on new lines.
+.SH "OPTIONS"
+Options start with #% (to preserve backwards compatibility).
+
+# This enables the "foo" option.
+.br
+#%foo
+.TP
+.B no-locale-archive
+Disable generation of the locale archive file and instead generate multiple
+files/directories for each locale.  This slows down runtime greatly (by having
+multiple files spread out in the filesystem instead of a single binary file),
+but it does mean build time is much faster (as you can generate in parallel).
+
+You should not use this option.
+.SH "EXAMPLES"
+.nf
+# Create a "en_US" locale using ISO-8859-1 encoding.
+# When you set LANG=en_US or LANG=en_US.ISO-8859-1, this is used.
+.B en_US ISO-8859-1
 
-Options start with #% (to preserve backwards compatibility).  The only option
-currently recognized is \fIno-locale-archive\fR.  This will disable generation
-of the locale archive file and instead generate multiple files/directories for
-each locale.
+# Create a "en_US" locale using UTF-8 encoding.
+# When you set LANG=en_US.UTF-8, this is used.
+.B en_US.UTF-8 UTF-8
+.fi
 .SH "SEE ALSO"
-.BR locale-gen (8),
+.BR locale (1),
 .BR localedef (1),
-.BR locale (1)
-.SH "AUTHOR"
+.BR locale-gen (8)
+.SH "AUTHORS"
+.nf
 Alastair McKinstry <mckinstry@××××××××.org>
+Mike Frysinger <vapier@g.o>
+.fi