home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / i18nv104.zip / SAMPLE / ULCASE / READ.ME < prev    next >
Text File  |  1996-02-13  |  4KB  |  107 lines
  1.  
  2. ===============================================================================
  3.                   Internationalization (I18N) For OS/2                 
  4. ===============================================================================
  5.  
  6.                 Copyright IBM Corporation -- 1993, 1994, 1995
  7.  
  8. DISCLAIMER: This package is not a full implementation of the X/Open XPG4 
  9. specification and does not make any claims of XPG4 branding. It implements 
  10. only the portions of the XPG4 specification which deal with 
  11. internationalization.
  12.  
  13. X/Open is a trademark of the X/Open Company Limited.
  14.  
  15. ===============================================================================
  16.  
  17.  
  18. /************************/
  19. /***     Contents     ***/
  20. /************************/
  21.  
  22. 1.  Overview
  23. 2.  Files in this directory
  24. 3.  How to run the sample program
  25. 4.  How to compile the sample program
  26. 5.  Notes
  27.  
  28. 1.  Overview
  29. ============
  30.  
  31. The sample program in this directory uses the "toupper" and "tolower" functions
  32. to show conversion from upper to lower case and visa versa.
  33.  
  34. These functions are culturally sensitive because most locales do not have case
  35. in their alphabets.  Further, accented characters must be converted to the
  36. proper character.
  37.  
  38. Note: Some of the upper case characters for accented characters are not shown
  39.       properly in the US 437 code page.  If the program were to be run on a
  40.       machine running the code page for the locale, the character would display
  41.       correctly.
  42.  
  43.  
  44. 2.  Files in this directory
  45. ===========================
  46.  
  47. File            Purpose
  48. ------------------------------------------------------------------------------
  49. ul.c            Source code for the ul sample program.
  50. ul.def          Definition file needed for compiling the program.
  51. ul.mak          Make file used to compile the sample.
  52. ul.exe          Compiled version of the ul sample.
  53.  
  54. build.cmd       A command file which will compile and link the sample program.
  55. read.me         This file.
  56.  
  57.  
  58. 3.  How to run the sample program
  59. =================================
  60.  
  61. The following steps show how the program can be run.
  62.  
  63.      1) Run the \i18n\bin\new_vars command file (or have the environment
  64.         variables already set).
  65.  
  66.      2) Set the value of either LC_ALL or LANG to: En_US (US English).
  67.  
  68.           Ex:   set LANG=En_US
  69.  
  70.      3) Execute the ul.exe program.
  71.  
  72.           Ex:   ul
  73.  
  74.      4) Experiment with changing the values of the LANG environment
  75.         variable.  Try the Fr_FR locale to see the difference in the
  76.         results.  Before you run the program in french, change the
  77.         current codeset "chcp 850" so all of the characters display
  78.         correctly.  When you're done, change the code set back to 437.
  79.  
  80.  
  81. 4.  How to compile the sample program
  82. =====================================
  83.  
  84. NOTE: The sample program is already compiled for you.  If you want to see the
  85.  behavior of the program, you can just run it.  The following instructions
  86.  are needed only if you want to modify the program and recompile it.
  87.  
  88. To compile the sample application:
  89.  
  90.      1) Make sure that the CSET/2 compiler and OS/2 toolkit are installed
  91.         correctly on your system.
  92.  
  93.      2) cd to the directory which contains the is source files.
  94.  
  95.      3) Type "build" at the command prompt.
  96.  
  97.  
  98. 5.  Notes
  99. =========
  100. 1. Some of the upper case characters for accented characters are not shown
  101.    properly in the US 437 code page.  If the program were to be run on a
  102.    machine running the code page for the locale, the character would display
  103.    correctly.
  104.  
  105. 2. Note that these functions are similar to the functions in the "ulcase_w"
  106.    directory, only these operate on characters, not wide characters.
  107.