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 <[email protected]> +Mike Frysinger <[email protected]> +.fi
