
===============================================================================
                  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.  How to run the sample program
4.  How to compile the sample program


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

The sample program in this directory uses the "isw*" APIs.  These functions are
used to determine if wide characters fall in to one of many different classes. 
For example, is a specific wide character alphabetic?  
or is it a punctuation mark?

The reason that these functions are provided as part of I18N is that the isw*
tests vary based on locale.  What is considered alphanumeric in one part of
the world is not in another part of the world.  Thus, these functions must
be culturally sensitive.

Note that these functions are similar to the is* functions in the "is"
directory, only these operate on wide characters, not characters.

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

File            Purpose
------------------------------------------------------------------------------
isw.c           Source code for the isw sample program.
isw.def         Definition file needed for compiling the program.
isw.mak         Make file used to compile the sample.
isw.exe         Compiled version of the isw sample.

build.cmd       A command file which will compile and link the sample program.
read.me         This file.


3.  How to run the sample program
=================================

The following steps show how the program can be run.

     1) Run the \i18n\bin\new_vars command file (or have the environment
        variables already set).

     2) Set the value of either LC_ALL or LANG to: En_US (US English).

          Ex:   set LANG=En_US

     3) Execute the isw.exe program.

          Ex:   isw

     4) Experiment with changing the values of the LANG environment
        variable.  Try the Fr_FR.IBM-850 locale to see the difference in the
        results (for example, some accented characters are alphabetic in 
        Fr_FR.IBM-850, whereas none of them are in En_US).  Try other locales
        to see the difference.  Note: You may wish to change the codeset
        of OS/2 to 850 before running this program with the french locale.
        This can be done with the 'chcp' command:

          Ex: chcp 850

        When you are finished, change the codepage back to 437.


4.  How to compile the sample program
=====================================

NOTE: The sample program is already compiled for you.  If you want to see the
 behavior of the program, you can just run it.  The following instructions
 are needed only if you want to modify the program and recompile it.

To compile the sample application:

     1) Make sure that the CSET/2 compiler and OS/2 toolkit are installed
        correctly on your system.

     2) cd to the directory which contains the is source files.

     3) Type "build" at the command prompt.
