Back to home page

glibc Cross Reference

 
 

    


0001                        POSIX locale descriptions
0002                                   and
0003                     POSIX character set descriptions
0004 
0005 Ulrich Drepper                  Time-stamp: <2004/11/27 13:06:54 drepper>
0006 drepper@redhat.com
0007 
0008 
0009 This directory contains the data needed to build the locale data files
0010 to use the internationalization features of the GNU libc.
0011 
0012 POSIX.2 describes the `localedef' utility which is part of the GNU libc.
0013 You need this program to "compile" the locale description in a form
0014 suitable for fast access by the GNU libc functions.  Any compilation is
0015 based on a given character set.
0016 
0017 Once you run `make install' for the GNU libc the data files are
0018 automatically installed in the right place, ready for use by the
0019 `localedef' program.
0020 
0021 To compile the locale data files you simply have to decide which locale
0022 (based on the location and the language) and which character set you
0023 use.  E.g., French speaking Canadians would use the locale `fr_CA' and
0024 the character set `ISO_8859-1,1987'.  Calling `localedef' to get the
0025 desired data should happen like this:
0026 
0027         localedef -i fr_CA -f ISO-8859-1 fr_CA
0028 
0029 This will place the 6 output files in the appropriate directory where
0030 the GNU libc functions can find them.  Please note that you need
0031 permission to write to this directory ($(prefix)/share/locale, where
0032 $(prefix) is the value you specified while configuring GNU libc).  If
0033 you do not have the necessary permissions, you can write the files into an
0034 arbitrary directory by giving a path including a '/' character instead
0035 of `fr_CA'.  E.g., to put the new files in a subdirectory of the
0036 current directory simply use
0037 
0038         localedef -i fr_CA -f ISO-8859-1 ./fr_CA
0039 
0040 How to use these data files is described in the GNU libc manual,
0041 especially in the section describing the `setlocale' function.
0042 
0043 All problems should be reported using
0044 
0045   http://sourceware.org/bugzilla/
0046 
0047 
0048 One more note: the `POSIX' locale definition is not meant to be used
0049 as an input file for `localedef'.  It is rather there to show the
0050 values with are built in the libc binaries as default values when no
0051 legal locale is found or the "C" or "POSIX" locale is selected.
0052 
0053 
0054                        The collation test suite
0055                        ########################
0056 
0057 This package also contains a (beginning of a) test suite for the
0058 collation functions in the GNU libc.  The files are provided sorted.
0059 The test program shuffles the lines and sort them afterwards.
0060 
0061 Some of the files are provided in 8bit form, i.e., not only ASCII
0062 characters.  So the tools you use to process the files should be 8bit
0063 clean.
0064 
0065 To run the test program the appropriate locale information must be
0066 installed.  Therefore the localedef program is used to generate this
0067 data used the locale and charmap description files contained here.
0068 Since we cannot run the localedef program in case of cross-compilation
0069 no tests at all are performed.
0070 
0071 
0072 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
0073 Local Variables:
0074  mode:text
0075  eval:(load-library "time-stamp")
0076  eval:(make-local-variable 'write-file-hooks)
0077  eval:(add-hook 'write-file-hooks 'time-stamp)
0078  eval:(setq time-stamp-format '(time-stamp-yyyy/mm/dd time-stamp-hh:mm:ss user-login-name))
0079 End: