
===============================================================================
                  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 shows how to extract the version inform-
mation from the setlocx.dll.


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

File            Purpose
------------------------------------------------------------------------------
version.c         Source code for the version sample program.
version.def       Definition file needed for compiling the program.
version.mak       Make file used to compile the sample.
version.exe       Compiled version of the version 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 version.exe program.

          Ex:   version

     4) The output from the program should be:

          Locale for monetary: ENUS437

          Value is 12345.6789    Symbol-less format 12345.68
          Value is -12.6789      International format USD 12.6789-
          Value is 45.6789       National format $0000045.68

     5) Experiment with changing the values of the LANG environment
        variable.  Try the Fr_FR locale to see the difference in the
        results.  Note: You should 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.
