home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / i18nv102.zip / SAMPLE / INFO / READ.ME < prev   
Text File  |  1995-09-19  |  4KB  |  109 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.  
  30.  
  31. 1.  Overview
  32. ============
  33.  
  34. The sample program in this directory demonstrates the use of the NL_LANGINFO
  35. and the LOCALECONV APIs.  These two APIs are used to query and get information
  36. about the current locale. See the technical reference for all of the
  37. information you can obtain with these two calls.
  38.  
  39.  
  40. 2.  Files in this directory
  41. ===========================
  42.  
  43. File            Purpose
  44. ------------------------------------------------------------------------------
  45. info.c          Source code for the info sample program.
  46. info.def        Definition file needed for compiling the program.
  47. info.mak        Make file used to compile the sample.
  48. info.exe        Compiled version of the info sample.
  49.  
  50. build.cmd       A command file which will compile and link the sample program.
  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 value of either LC_ALL or LANG to: en_us (US English).
  63.  
  64.           Ex:   set LANG=en_us
  65.  
  66.      3) Execute the info.exe program.
  67.  
  68.           Ex:   info
  69.  
  70.      4) The output from the program should be:
  71.  
  72.           WARNING: Different values reported by this program are based on
  73.                    different locale settings (LC_MONETARY, LC_TIME...)
  74.  
  75.           Locale settings: ENUS437 ENUS437 ENUS437 ENUS437 ENUS437 ENUS437
  76.  
  77.           Data from LOCALECONV:
  78.           ---------------------
  79.           International monetary symbol: USD
  80.           Negative sign: -
  81.           Number of fractional digits (after decimal point): 2
  82.  
  83.           Data from NL_LANGINFO:
  84.           ----------------------
  85.           Days of the week: Sun Mon Tue Wed Thu Fri Sat
  86.           Radix character is: .
  87.           Thousands separator: ,
  88.  
  89.      5) Experiment with changing the values of the LANG environment
  90.         variable.  Also, you can modify the program to print out other
  91.         values returned by the two APIs.
  92.  
  93.  
  94. 4.  How to compile the sample program
  95. =====================================
  96.  
  97. NOTE: The sample program is already compiled for you.  If you want to see the
  98.  behavior of the program, you can just run it.  The following instructions
  99.  are needed only if you want to modify the program and recompile it.
  100.  
  101. To compile the sample application:
  102.  
  103.      1) Make sure that the CSET/2 compiler and OS/2 toolkit are installed
  104.         correctly on your system.
  105.  
  106.      2) cd to the directory which contains the info source files.
  107.  
  108.      3) Type "build" at the command prompt.
  109.