

===============================================================================
                  Internationalization (I18N) For OS/2                 
===============================================================================

                Copyright IBM Corporation -- 1993, 1994, 1995

DISCLAIMER: This package is not a full implementation of the X/Open* XPG4 
specification and does not make any claims of XPG4 branding.  It implements 
only the portions of the XPG4 specification which deal with 
internationalization.

X/Open is a trademark of the X/Open Company Limited.

===============================================================================

/************************/
/***     Contents     ***/
/************************/

1.  Overview
2.  Files in this directory
3.  API and directory cross reference


1.  Overview
============

This directory contains subdirectories which each demonstrate the use of some
of the i18n APIs.  Most of the APIs provided with this package (as well as the
catalog command-line programs) are demonstrated.  The table at the end of this
file can be used to easily determine the subdirectories in which specific APIs
are used.

Note: "i18n" is a commonly used abbreviation for "internationalization".


2.  Files in this directory
===========================

The following is a list of the files in this directory:

File            Purpose
------------------------------------------------------------------------------
read.me         This file.
cat             Sample message catalog, and a program which uses it.
collate         Cultural collation samples.
dt              Date and time formatting samples.
info            Sample program which gets information about the current locale.
install         Fully functional utility for installing and customizing 
                 the I18N run-time environment. This is intended for 
                 products which include the I18N support and must install it. 
io              Input/output functions with wide characters and strings
                 (get and put operations).
is              Tests to determine if characters belong to specified groups
                 (alphabetic, numeric, printable etc.).
is_w            Same tests as "is" directory on wide characters.
money           Sample program to demonstrate locale-based monetary formatting.
numconv         Conversion from wide strings to numeric variables.
printf          Miscellaneous use of printf function.
regex		Miscellaneous use of the regular expression functions.
scan            Scanf/printf functions for wide characters and positional
                 parameters.
setloc          Demonstrate the use of the setlocale function.
ulcase          A program which shows the use of the upper/lower case function.
ulcase_w        Upper/lower case functions for wide characters.
vprintf         Miscellaneous use of vprintf function.
wconv           Sample of wide character <-> multibyte conversions.
world           PM 'world' application program to demonstrate i18n functions.
wstr            Demonstrates the various string functions for wide characters.
