From 016ac63c81b73a86d7cb60eea6ce35106c98f9b8 Mon Sep 17 00:00:00 2001 From: Helena Chapman Date: Wed, 27 Oct 1999 20:40:39 +0000 Subject: [PATCH] [ICU-72] Documentation update X-Commit-URL: https://ssl.icu-project.org/trac/changeset/134 --- icu4c/readme.html | 122 +++++++++++++++++++--------------------------- 1 file changed, 49 insertions(+), 73 deletions(-) diff --git a/icu4c/readme.html b/icu4c/readme.html index 7f010758fbd..c0dafe93913 100644 --- a/icu4c/readme.html +++ b/icu4c/readme.html @@ -28,8 +28,7 @@ ADP Schedule Contract with IBM Corp.


- 
- 

+   

Contents

@@ -67,23 +66,13 @@ independent applications: format to create messages
  • Text collation supporting language sensitive comparison of strings
  • Text boundary analysis for finding characters, word and sentence boundaries
    • +
  • Changing simple data files rather than modifying program code easily localizes + applications written using these tools
    • +
  • Over 150 locales supported. Visit LocaleExplorer + site for a demonstration and a full list of supported locales
    • -

    Changing simple data files rather than modifying program code easily localizes -applications written using these tools. The following locales are supported: ar, ar_AE, ar_BH, ar_DZ, ar_EG, ar_IQ, ar_JO, ar_KW, ar_LB, ar_LY, -ar_MA, ar_OM, ar_QA, ar_SA, ar_SD, ar_SY, ar_TN, ar_YE, be, be_BY, bg, bg_BG, ca, ca_ES, -ca_ES_EURO, cs, cs_CZ, da, da_DK, de, de_AT, de_AT_EURO, de_CH, de_DE, de_DE_EURO, de_LU, -de_LU_EURO, el, el_GR, en, en_AU, en_CA, en_GB, en_IE, en_IE_EURO, en_NZ, en_US, en_ZA, -es, es_AR, es_BO, es_CL, es_CO, es_CR, es_DO, es_EC, es_ES, es_ES_EURO, es_GT, es_HN, -es_MX, es_NI, es_PA, es_PE, es_PR, es_PY, es_SV, es_UY, es_VE, et, et_EE, fi, fi_FI, -fi_FI_EURO, fr, fr_BE, fr_BE_EURO, fr_CA, fr_CH, fr_FR, fr_FR_EURO, fr_LU, fr_LU_EURO, hr, -hr_HR, hu, hu_HU, index, is, is_IS, it, it_CH, it_IT, it_IT_EURO, iw, iw_IL, ja, ja_JP, -ko, ko_KR, lt, lt_LT, lv, lv_LV, mk, mk_MK, nl, nl_BE, nl_BE_EURO, nl_NL, nl_NL_EURO, no, -no_NO, no_NO_NY, pl, pl_PL, pt, pt_BR, pt_PT, pt_PT_EURO, ro, ro_RO, ru, ru_RU, sh, sh_YU, -sk, sk_SK, sl, sl_SI, sq, sq_AL, sr, sr_YU, sv, sv_SE, th, th_TH, tr, tr_TR, uk, uk_UA, -vi, vi_VN, zh, zh_CN, zh_HK, zh_TW.

    -

    It is possible to support additional locales by adding more locale data files, with no code changes.

    @@ -105,15 +94,13 @@ to fixing any bugs, and will also use your feedback to help plan future releases

    All files are contained in icu-XXXXXX.zip.
    Please unzip this file.  It will re-construct the source directory. Please be sure to -do "unzip -a icu-XXXXXX.zip -d drive:\directory" on Win32 platforms. -  This will convert the line feed/carriage return characters correctly on windows. -  Before running the test programs or samples, please set the environment variable ICU_DATA, -the full pathname of the data directory, to indicate where the locale data files and -conversion mapping tables are.  If this variable is not set, the default user data -directory will be used.

    +do "unzip -a icu-XXXXXX.zip -d drive:\directory" or use WinZip +on Win32 platforms.   This will convert the line feed/carriage return characters +correctly on windows.  

    -

    Below, $Root is the placement of the icu directory in your file system, like "drive:\...\icu" in your environment. -"drive:\..." stands for any drive and any directory on that drive that you chose to install icu into.

    +

    Below, $Root is the placement of the icu directory in your file system, like +"drive:\...\icu" in your environment. "drive:\..." stands for any +drive and any directory on that drive that you chose to install icu into.

    The following files describe the code drop:
     
    @@ -178,39 +165,17 @@ directory will be used.

    $Root\source\tools\genrb This tool converts the portable locale data files in text format to - machine-specific binary format for resource bundle performance efficiency.  To run - this tool on all the locale data files, please type the following commands on the - supported platforms: - + machine-specific binary format for resource bundle performance efficiency. $Root\source\tools\gencol -  

    This tool converts the collation rules in the portable locale data - files in text format to machine-specific binary collation data.  To run this tool for - all the supported collators, please type the following under the command prompt on the - supported platforms:

    - + This tool converts the collation rules in the portable locale data files + in text format to machine-specific binary collation data. $Root\source\tools\makeconv -  

    This tool converts the native encoding to/from UCS-2 mapping table in - text format to machine-specific binary format.  To run this tool for all the - supported converters, please type the following under the command prompt on the supported - platforms:

    - + This tool converts the native encoding to/from UCS-2 mapping table in text + format to machine-specific binary format. @@ -237,8 +202,8 @@ Classes for Unicode:

            output                  icu      _____|_____ ______________|______________________________     |         |     |     |             |        | | - libraries programs  include data         source       | | - (built) (built) (built)               |       readme.html license.html + libraries programs  include data         source      | | + (built) (built) (built)               |      readme.html license.html                                       |            _________________|__________________________          | |       |       | | | @@ -341,8 +306,8 @@ the wrong one.

    To change your PATH:  Do this under NT by using the System control panel. Pick the "Environment" tab, select the variable PATH in the lower box.  In -the "value" box, append the string ";drive:\...\icu\bin\Debug" at the end of -the path string.  If there is nothing there, just type in +the "value" box, append the string ";drive:\...\icu\bin\Debug" at the +end of the path string.  If there is nothing there, just type in "drive:\...\icu\bin\Debug". Click the Set button, then the Ok button.

    Link with Runtime libraries: All the DLLs link with the C runtime library @@ -367,12 +332,13 @@ this, you will seemingly get memory errors when you run the executable.

    The steps are:

      -
    1. Unzip the icu-XXXX.zip file, type "unzip -a icu-XXXX.zip -d drive:\directory" under - command prompt.  drive:\directory\icu is the root ($Root) directory - (you may but don't need to place "icu" into another directory). - If you change the root, you will - change the project settings accordingly in EACH makefile in the project, updating the - include and library paths.
      2. +
    2. Unzip the icu-XXXX.zip file, type "unzip -a icu-XXXX.zip -d drive:\directory" + under command prompt or use WinZip.  drive:\directory\icu is the root ($Root) + directory (you may but don't need to place "icu" into another directory). If you + change the root, you will change the project settings accordingly in EACH makefile in the + project, updating the include and library paths.
      3. +
    3. Set the environment variable ICU_DATA, the full pathname of the data + directory, to indicate where the locale data files and conversion mapping tables are.
    4. Start Microsoft Visual C++ 6.0.
    5. Choose "File" menu and select "Open WorkSpace".
    6. In the file chooser, choose icu\source\allinone\allinone.dsw. Open this workspace.
      7. @@ -387,19 +353,23 @@ this, you will seemingly get memory errors when you run the executable.
      the Debug and Release configurations at the same time, choose "Build" menu and select "Batch Build..." instead (and mark all configurations as checked), then click the button named "Rebuild All". -
    7. Repeat step6-8 and set "makeconv" project to be active and build the makeconv - tool.
      8. -
    8. Repeat step9 to build both genrb and gencol tools.
      9. -
    9. Run the mkcnvfle.bat script to create the converter data files in binary format.
      10. -
    10. Run the genrb.bat script to create the locale data files in binary format.
      11. +
    11. Repeat steps 7-9 for makeconv (set active project to "makeconv"), genrb + ("genrb") and gencol ("gencol") tools.
      12. +
    12. Run the mkcnvfle.bat script to create the converter data files in binary format. The + script requires two arguments, where first is either "Release" or + "Debug" reflecting the type of build and the second is path to the icu + directory.
      13. +
    13. Run the genrb.bat script to create the locale data files in binary format. The script + requires two arguments, where first is either "Release" or "Debug" + reflecting the type of build and the second is path to the icu directory
    14. Run the gencol.exe program to pre-load the collation data and create the collation data in binary format.
      15. -
    15. Save the value of the "TZ" environment variable and then set it to - "PST8PDT". 
      16. +
    16. Save the value of the TZ environment variable and then set it to PST8PDT.  +
    17. Reopen the "allinone" project file and run the "intltest" test. -   Reset the "TZ" value.
      18. -
    18. To run the C test suite, set "cintltst" as the active project and repeat step - 7, 8 and then run the "cintltst" test..
      19. +   Reset the TZ value. +
    19. To run the C test suite, set "cintltst" as the active project, repeat steps 8, + 9 and then run the "cintltst" test..
    20. Build and run as outlined above.
    @@ -418,7 +388,7 @@ this, you will seemingly get memory errors when you run the executable.
    them on the menu bar for later selection. -

    It is also possible to build each library individually, using the Makefiles in each +

    It is also possible to build each library individually, using the workspaces in each respective directory. They have to be built in the following order:
            1. common
            2. i18n
    @@ -445,7 +415,13 @@ version of GNU make (3.7+).

    1. Unzip the icu-XXXX.zip file with the "-a" option.
      2. +
    2. Before running the test programs or samples, please set the environment variable ICU_DATA, + the full pathname of the data directory, to indicate where the locale data files and + conversion mapping tables are.  If this variable is not set, the default user data + directory will be used.
    3. Change directory to the "icu/source".
      4. +
    4. If it is not already set, please set the executable flag for the following files (by + executing 'chmod +x' command): configure, install.sh and config.*,
    5. Type "./configure" or type "./configure --help" to print the avialable options.
    6. Type "make" to compile the libraries and all the data files.