home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / i18nv102.zip / SAMPLE / ULCASE_W / READ.ME < prev    next >
Text File  |  1995-09-19  |  4KB  |  106 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. 1.  Overview
  32. ============
  33.  
  34. The sample program in this directory uses the "towupper" and "towlower"
  35. functions to show conversion from upper to lower case for wide characters,
  36. and visa versa.
  37.  
  38. These functions are culturally sensitive because most locales do not have case
  39. in their alphabets.  Further, accented characters must be converted to the
  40. proper character.
  41.  
  42.  
  43. 2.  Files in this directory
  44. ===========================
  45.  
  46. File            Purpose
  47. ------------------------------------------------------------------------------
  48. ul_w.c          Source code for the ul_w sample program.
  49. ul_w.def        Definition file needed for compiling the program.
  50. ul_w.mak        Make file used to compile the sample.
  51. ul_w.exe        Compiled version of the ul_w sample.
  52.  
  53. build.cmd       A command file which will compile and link the sample program.
  54. read.me         This file.
  55.  
  56.  
  57. 3.  How to run the sample program
  58. =================================
  59.  
  60. The following steps show how the program can be run.
  61.  
  62.      1) Run the \i18n\bin\new_vars command file (or have the environment
  63.         variables already set).
  64.  
  65.      2) Set the value of either LC_ALL or LANG to: en_us (US English).
  66.  
  67.           Ex:   set LANG=en_us
  68.  
  69.      3) Execute the ul_w.exe program.
  70.  
  71.           Ex:   ul_w
  72.  
  73.      4) Experiment with changing the values of the LANG environment
  74.         variable.  Try the fr_fr locale to see the difference in the
  75.         results.  Make sure that you change to code set 850 ("chcp 850")
  76.         before you run the program in french, as this will properly display
  77.         all of the symbols.  When you're done, change back to 437.
  78.  
  79.  
  80. 4.  How to compile the sample program
  81. =====================================
  82.  
  83. NOTE: The sample program is already compiled for you.  If you want to see the
  84.  behavior of the program, you can just run it.  The following instructions
  85.  are needed only if you want to modify the setlocale program and recompile it.
  86.  
  87. To compile the sample application:
  88.  
  89.      1) Make sure that the CSET/2 compiler and OS/2 toolkit are installed
  90.         correctly on your system.
  91.  
  92.      2) cd to the directory which contains the is source files.
  93.  
  94.      3) Type "build" at the command prompt.
  95.  
  96.  
  97. 5.  Notes
  98. =========
  99. 1. Some of the upper case characters for accented characters are not shown
  100.    properly in the US 437 code page.  If the program were to be run on a
  101.    machine running the code page for the locale, the character would display
  102.    correctly.
  103.  
  104. 2. Note that these functions are similar to the functions in the "ulcase"
  105.    directory, only these operate on wide characters, not characters.
  106.