home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / i18nv102.zip / SAMPLE / ICONV / READ.ME < prev   
Text File  |  1995-09-19  |  3KB  |  95 lines
  1.  
  2. ===============================================================================
  3.                   Internationalization (I18N) For OS/2                 
  4. ===============================================================================
  5.  
  6.                 Copyright IBM Corporation -- 1993, 1994, 1995
  7.  
  8. DISCLAIMER: This I18N package has been made available solely to gauge OS/2
  9. developer interest in the industry standard XPG4 internationalization 
  10. programming model. This does not mean that IBM will introduce a product based
  11. on the contents of this package. This package is not a full implementation of 
  12. the X/Open XPG4 specification and does not make any claims of XPG4 branding. 
  13. It implements only the portions of the XPG4 specification which deal with 
  14. internationalization.
  15.  
  16. X/Open is a trademark of the X/Open Company Limited.
  17.  
  18. ===============================================================================
  19.  
  20.  
  21. /************************/
  22. /***     Contents     ***/
  23. /************************/
  24.  
  25. 1.  Overview
  26. 2.  Files in this directory
  27. 3.  How to run the sample program
  28. 4.  How to compile the sample program
  29. 5.  Notes
  30.  
  31.  
  32. 1.  Overview
  33. ============
  34.  
  35. The sample program in this directory demonstrates the use of the iconv
  36. family of functions. These functions are used to convert between different
  37. code sets. 
  38.  
  39.  
  40. 2.  Files in this directory
  41. ===========================
  42.  
  43. File            Purpose
  44. ------------------------------------------------------------------------------
  45. convert.c        Source code for the convert sample program.
  46. convert.def      Definition file needed for compiling the program.
  47. makefile         Make file used to compile the sample.
  48. convert.exe      Compiled version of the convert sample.
  49. build.cmd        A command file which will compile and link the sample program.
  50. 850.txt          Test data of IBM-850 text.
  51. read.me          This file.
  52.  
  53.  
  54. 3.  How to run the sample program
  55. =================================
  56.  
  57. The following steps show how the program can be run.
  58.  
  59.      1) Run the \i18n\bin\new_vars command file (or have the environment
  60.         variables already set).
  61.  
  62.      2) Set the current locale (e.g. to US English)
  63.  
  64.           set LANG=en_us
  65.  
  66.      3) Execute the convert.exe program with the appropriate arguments.
  67.  
  68.         The synteax is:
  69.   
  70.           convert FROM_CODE_PAGE TO_CODE_PAGE 
  71.  
  72.         It reads from standard input and writes to standard output.
  73.  
  74.         The following example converts from IBM-850 to an EBCDIC code set:
  75.  
  76.           convert IBM-850 IBM-037 < 850.txt > 037.txt
  77.  
  78.  
  79. 4.  How to compile the sample program
  80. =====================================
  81.  
  82. NOTE: The sample program is already compiled for you.  If you want to see the
  83.  behavior of the program, you can just run it.  The following instructions
  84.  are needed only if you want to modify the program and recompile it.
  85.  
  86. To compile the sample application:
  87.  
  88.      1) Make sure that the CSET compiler and OS/2 toolkit are installed
  89.         correctly on your system.
  90.  
  91.      2) cd to the directory which contains the info source files.
  92.  
  93.      3) Type "build" at the command prompt.
  94.  
  95.