home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / i18nv104.zip / SAMPLE / IS_W / READ.ME < prev   
Text File  |  1996-02-13  |  4KB  |  102 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.  
  27.  
  28. 1.  Overview
  29. ============
  30.  
  31. The sample program in this directory uses the "isw*" APIs.  These functions are
  32. used to determine if wide characters fall in to one of many different classes. 
  33. For example, is a specific wide character alphabetic?  
  34. or is it a punctuation mark?
  35.  
  36. The reason that these functions are provided as part of I18N is that the isw*
  37. tests vary based on locale.  What is considered alphanumeric in one part of
  38. the world is not in another part of the world.  Thus, these functions must
  39. be culturally sensitive.
  40.  
  41. Note that these functions are similar to the is* functions in the "is"
  42. directory, only these operate on wide characters, not characters.
  43.  
  44. 2.  Files in this directory
  45. ===========================
  46.  
  47. File            Purpose
  48. ------------------------------------------------------------------------------
  49. isw.c           Source code for the isw sample program.
  50. isw.def         Definition file needed for compiling the program.
  51. isw.mak         Make file used to compile the sample.
  52. isw.exe         Compiled version of the isw 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 isw.exe program.
  71.  
  72.           Ex:   isw
  73.  
  74.      4) Experiment with changing the values of the LANG environment
  75.         variable.  Try the Fr_FR.IBM-850 locale to see the difference in the
  76.         results (for example, some accented characters are alphabetic in 
  77.         Fr_FR.IBM-850, whereas none of them are in En_US).  Try other locales
  78.         to see the difference.  Note: You may wish to change the codeset
  79.         of OS/2 to 850 before running this program with the french locale.
  80.         This can be done with the 'chcp' command:
  81.  
  82.           Ex: chcp 850
  83.  
  84.         When you are finished, change the codepage back to 437.
  85.  
  86.  
  87. 4.  How to compile the sample program
  88. =====================================
  89.  
  90. NOTE: The sample program is already compiled for you.  If you want to see the
  91.  behavior of the program, you can just run it.  The following instructions
  92.  are needed only if you want to modify the program and recompile it.
  93.  
  94. To compile the sample application:
  95.  
  96.      1) Make sure that the CSET/2 compiler and OS/2 toolkit are installed
  97.         correctly on your system.
  98.  
  99.      2) cd to the directory which contains the is source files.
  100.  
  101.      3) Type "build" at the command prompt.
  102.