mirror of
https://sourceware.org/git/glibc.git
synced 2024-11-30 08:40:07 +00:00
80 lines
3.1 KiB
Plaintext
80 lines
3.1 KiB
Plaintext
POSIX locale descriptions
|
|
and
|
|
POSIX character set descriptions
|
|
|
|
Ulrich Drepper Time-stamp: <2004/11/27 13:06:54 drepper>
|
|
drepper@redhat.com
|
|
|
|
|
|
This directory contains the data needed to build the locale data files
|
|
to use the internationalization features of the GNU libc.
|
|
|
|
POSIX.2 describes the `localedef' utility which is part of the GNU libc.
|
|
You need this program to "compile" the locale description in a form
|
|
suitable for fast access by the GNU libc functions. Any compilation is
|
|
based on a given character set.
|
|
|
|
Once you run `make install' for the GNU libc the data files are
|
|
automatically installed in the right place, ready for use by the
|
|
`localedef' program.
|
|
|
|
To compile the locale data files you simply have to decide which locale
|
|
(based on the location and the language) and which character set you
|
|
use. E.g., French speaking Canadians would use the locale `fr_CA' and
|
|
the character set `ISO_8859-1,1987'. Calling `localedef' to get the
|
|
desired data should happen like this:
|
|
|
|
localedef -i fr_CA -f ISO-8859-1 fr_CA
|
|
|
|
This will place the 6 output files in the appropriate directory where
|
|
the GNU libc functions can find them. Please note that you need
|
|
permission to write to this directory ($(prefix)/share/locale, where
|
|
$(prefix) is the value you specified while configuring GNU libc). If
|
|
you do not have the necessary permissions, you can write the files into an
|
|
arbitrary directory by giving a path including a '/' character instead
|
|
of `fr_CA'. E.g., to put the new files in a subdirectory of the
|
|
current directory simply use
|
|
|
|
localedef -i fr_CA -f ISO-8859-1 ./fr_CA
|
|
|
|
How to use these data files is described in the GNU libc manual,
|
|
especially in the section describing the `setlocale' function.
|
|
|
|
All problems should be reported using
|
|
|
|
http://sources.redhat.com/bugzilla/
|
|
|
|
|
|
One more note: the `POSIX' locale definition is not meant to be used
|
|
as an input file for `localedef'. It is rather there to show the
|
|
values with are built in the libc binaries as default values when no
|
|
legal locale is found or the "C" or "POSIX" locale is selected.
|
|
|
|
|
|
The collation test suite
|
|
########################
|
|
|
|
This package also contains a (beginning of a) test suite for the
|
|
collation functions in the GNU libc. The files are provided sorted.
|
|
The test program shuffles the lines and sort them afterwards.
|
|
|
|
Some of the files are provided in 8bit form, i.e., not only ASCII
|
|
characters. So the tools you use to process the files should be 8bit
|
|
clean.
|
|
|
|
To run the test program the appropriate locale information must be
|
|
installed. Therefore the localedef program is used to generate this
|
|
data used the locale and charmap description files contained here.
|
|
Since we cannot run the localedef program in case of cross-compilation
|
|
no tests at all are performed.
|
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
Local Variables:
|
|
mode:text
|
|
eval:(load-library "time-stamp")
|
|
eval:(make-local-variable 'write-file-hooks)
|
|
eval:(add-hook 'write-file-hooks 'time-stamp)
|
|
eval:(setq time-stamp-format '(time-stamp-yyyy/mm/dd time-stamp-hh:mm:ss user-login-name))
|
|
End:
|