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