
===============================================================================
                  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
5.  Notes


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

The sample program in this directory demonstrates the use of the iconv
family of functions. These functions are used to convert between different
code sets. 


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

File            Purpose
------------------------------------------------------------------------------
convert.c        Source code for the convert sample program.
convert.def      Definition file needed for compiling the program.
makefile         Make file used to compile the sample.
convert.exe      Compiled version of the convert sample.
build.cmd        A command file which will compile and link the sample program.
850.txt          Test data of IBM-850 text.
read.me          This file.


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

The following steps show how the program can be run.

     1) Execute the convert.exe program with the appropriate arguments.

        The synteax is:
  
          convert FROM_CODE_PAGE TO_CODE_PAGE 

        It reads from standard input and writes to standard output.

        The following example converts from IBM-850 to an EBCDIC code set:

          convert IBM-850 IBM-037 < 850.txt > 037.txt


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 compiler and OS/2 toolkit are installed
        correctly on your system.

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

     3) Type "build" at the command prompt.

