projects / apple / icu.git / blame
| Commit | Line | Data |
|---|---|---|
| b75a7d8f A |
1 | <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN"> |
| 2 | <html> | |
| 3 | ||
| 4 | <head> | |
| 5 | <meta http-equiv="Content-Type" | |
| 6 | content="text/html; charset=iso-8859-1"> | |
| 7 | <meta name="Copyright" content="Copyright (c) 2002, International Business Machines Corporation and others. All Rights Reserved."> | |
| 8 | <meta name="GENERATOR" content="Microsoft FrontPage 2.0"> | |
| 9 | <title>ReadMe: Character Set Conversion Tool for Unicode</title> | |
| 10 | </head> | |
| 11 | ||
| 12 | <body bgcolor="#FFFFFF"> | |
| 13 | ||
| 14 | <p><font size="5"><b>ReadMe: The Character Set Conversion Tool | |
| 15 | for Unicode</b></font> </p> | |
| 16 | ||
| 17 | <p>Version: <!--webbot bot="Timestamp" startspan | |
| 18 | s-type="EDITED" s-format="%m/%d/%y" -->10/01/98<!--webbot | |
| 19 | bot="Timestamp" i-checksum="13821" endspan --> <br> | |
| 20 | </p> | |
| 21 | ||
| 22 | <hr> | |
| 23 | ||
| 24 | <p>COPYRIGHT: <br> | |
| 25 | (C) Copyright International Business Machines Corporation, 1998 <br> | |
| 26 | Licensed Material - Program-Property of IBM - All Rights | |
| 27 | Reserved. <br> | |
| 28 | US Government Users Restricted Rights - Use, duplication, or | |
| 29 | disclosure restricted by GSA ADP Schedule Contract with IBM Corp. | |
| 30 | <br> | |
| 31 | </p> | |
| 32 | ||
| 33 | <hr> | |
| 34 | ||
| 35 | <p><font size="4"><b>Introduction</b></font> </p> | |
| 36 | ||
| 37 | <p><b>makeconv</b> is a tool that converts character set | |
| 38 | conversion data into binary files for use by the UnicodeConverter | |
| 39 | C code. The UnicodeConverter code will not function with text | |
| 40 | format data files. The user of charset conversion library will | |
| 41 | need to convert all the data files in text format into binary | |
| 42 | format. </p> | |
| 43 | ||
| 44 | <p>For a IBM registered code page to/from Unicode conversion data | |
| 45 | file in the specified data path, it generates .cnv files, which | |
| 46 | it puts in the same directory. The tool takes a list of file | |
| 47 | names as argument, with their absolute or relative path, and will | |
| 48 | generate a corresponding ".cnv" file with the same | |
| 49 | path. On Unix shells one can easily convert all the | |
| 50 | ".cnv" files from the text files in the data directory | |
| 51 | by using wildcards (e.g. <b>makeconv ../../data/locales/*.ucm</b>). | |
| 52 | On Win32 we have provided a batch file "<b>mkcnvfle.bat</b>" | |
| 53 | in the same directory you will find <b>makeconv.c</b>. <b>mkcnvfle</b> | |
| 54 | converts all the ".ucm" files in intlwork/data/locales | |
| 55 | to ".cnv" files. It requires one argument : Debug or | |
| 56 | Release so it knows where to look for the makeconv.exe. <br> | |
| 57 | (Win32 usage:<b> \intlwork\tools\makeconv\mkcnvfle.bat Debug</b> | |
| 58 | for debug build, <b>\intlwork\tools\makeconv\mkcnvfle.bat Release</b>, | |
| 59 | otherwise<b>.</b>) </p> | |
| 60 | ||
| 61 | <ul> | |
| 62 | <li><b>Create a binary file for codepage IBM-949 in the data | |
| 63 | path "\intlwork\data\locales\"</b>: type in at | |
| 64 | the command prompt, "<b>makeconv</b><font | |
| 65 | face="Courier"> \intlwork\data\locales\ibm-949.ucm". | |
| 66 | </font>The generated binary file will be located in the | |
| 67 | same directory.</li> | |
| 68 | <li><b>Look for the codepage IBM-949 data file in the current | |
| 69 | working directory</b>: type in at the command prompt, | |
| 70 | "<b>makeconv</b><font face="Courier"> ibm-949.ucm</font>". | |
| 71 | The tool will try to locate the file "<font | |
| 72 | face="Courier">ibm-949.ucm</font>" in the current | |
| 73 | directory. The generated binary file, "<font | |
| 74 | face="Courier">ibm-949.cnv</font>" will be located | |
| 75 | in current working directory.</li> | |
| 76 | </ul> | |
| 77 | ||
| 78 | <p><font size="4"><b>Building the Tool</b></font> </p> | |
| 79 | ||
| 80 | <p><font size="3">To build the tool on Win32 environment is very | |
| 81 | easy, simply open the "makeconv</font><font size="3" | |
| 82 | face="Courier">.dsw</font><font size="3">" workspace project | |
| 83 | file in MSVC++ 5.0 compiler.</font> <br> | |
| 84 | On Unix the process of building the tool and the ".cnv" | |
| 85 | files is included in the build process of the library. The | |
| 86 | provided makefiles will <br> | |
| 87 | attempt to build <b>makeconv</b> as it builds other parts of the | |
| 88 | library. It will also convert all the initial ".ucm" | |
| 89 | files in data/locales to ".cnv" files. </p> | |
| 90 | ||
| 91 | <p><font size="4"><b>Limitations</b></font> </p> | |
| 92 | ||
| 93 | <p>The tools uses stdio.h functions to communicate success or | |
| 94 | failure to the user. Platforms that don't support stdio will have | |
| 95 | to adapt <br> | |
| 96 | that portion of the code. <br> | |
| 97 | </p> | |
| 98 | </body> | |
| 99 | </html> |