

ReadMe: IBM Unicode Locale for Linux

Version 1.00
Date: October 27, 2000

-------------------------------------------------------------------------------
COPYRIGHT: 

Copyright (c) 2000 International Business Machines Corporation and others. 
All Rights Reserved.
-------------------------------------------------------------------------------

1. Introduction

Open source software is going to be globalized today and Linux is the 
mainstream of open source software for globalization. Unicode Locale for 
Linux provides over 100 Unicode based locale source files and object in order
to progress Linux Globalization.


2. License

These all contents are provided under IBM Public License. 
Please see "Licence.txt" for further detailed information about 
IBM Public License. 


3. Functional Objective

IBM Unicode Locale for Linux is developed to conform/support the following 
standards/implementations.

- The Unicode Version 3.0  
   http://www.unicode.org/

- The ICU - International Components for Unicode
   http://oss.software.ibm.com/icu/index.html

The following standard and techinical report are referred. 

- The ISO International string ordering (future ISO/IEC 14651). 
   http://anubis.dkuug.dk/jtc1/sc22/wg20/docs/projects#14651

- The ISO Cultural convention specification TR (future ISO/IEC TR 14652)..*
   http://anubis.dkuug.dk/jtc1/sc22/wg20/docs/projects#14652

Note *: This is to keep compatibility with current glibc locale implementation.



3.1 LC_CTYPE

Character class (LC_CTYPE) is auto-generated from "UnicodeData.txt" provided 
by Unicode org. (ftp://ftp.unicode.org/Public/UNIDATA/)
 
3.2 LC_COLLATE
 
- Collation table is generated from collation key table provide by Unicode org.
  CJK is not defined. Will be supported next version. 

- Collation result is the same as ICU default locale(root).  

3.3 Others

- LC_TIME, LC_NUMERIC, LC_MONETARY, LC_MESSAGES are auto-generated 
  based on ICU locales.  
- LC_PAPER, LC_NAME, LC_ADDRESS, LC_TELEPHONE, LC_MESUREMENT are 
  added based on IBM National Language Design Guide Volume 2.
  Publication No. is SE09-8002-03.  
- UTF-8 based charmap is auto-generated from "UnicodeData.txt" provided by 
  Unicode org.  


4. Package information

This package includes;

- Locale source files for glibc V2.2
- Readme.txt
- License.txt


5. Installation

5.1 zcat iul-1.00-src.tar.gz | tar xvf -

5.2 The following directories are generated.

       ./ul/src/locale       ... locale source file
       ./ul/src/cmap         ... utf-8 charmap file
       ./ul/doc              ... ReadMe.txt, License.txt
       ./ul/buildlocale.sh   ... Instlation script
  
5.3 There are two ways for installation
      
   - Use localedef command 
     e.g. 
         localedef -i fr_BE@euro -f charmap.utf8 -c fr_BE@euro.utf8

   After compile, locale object is installed /usr/lib/locale/ automatically. 
   It takes about 10 minutes to complete one locale on Intel 
   Pentium II 350 Mhz, 192MB Mem, or about half an hour to compile whole locales.

   or

   - Use buildlocale.sh
     
   Type buildlocale.sh and follow the instruction.
 
 
5.4 Make sure the locale installed with locale -a command. 


6. Restriction of this version

- LC_COLLATE temporary adds Unicode V3.0 new characters in binary order. 
  It will be replaced with the update by ISO SC22/WG20 International string 
  ordering project.
- LC_COLLATE is not tailored yet for each locale. Will be updated by this 
  October. 
- Currently total locales are 112. By this October, this will be increased 
  over 150 locales which are identified by LI18NUX 2000 specification. 
- The following locales have no LC_MESSAGES. Currentry N/A is assigned. 

  sl_SI
  sq_AL
  sr_YU
  th_TH
  vi_VN


7. Testing status. 
  
Tested on the following environment only.

- H/W Intel Pentium II 350 Mhz. 192MB Mem.
- S/W RedHat V7.0 English.  glibc version 2.1.92.14

8. Bug report

 Pleaes use bug traking system from Web. 
 url : http://oss.software.ibm.com/developerworks/opensource/locale/bugs


-------------------------------------------------------------------------------
Copyright (c) 2000 International Business Machines Corporation and others. 
All Rights Reserved.

Globalization Center of Competency, Yamato Software Laboratory
1623-14, Shimotsuruma, Yamato-shi, 
Kanagawa-ken, 242-8502, Japan
-------------------------------------------------------------------------------
