icuSources/tools/makeconv/readme.htm

   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:&nbsp;<!--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 &quot;.cnv&quot; file with the same
  49 path. On Unix shells one can easily convert all the
  50 &quot;.cnv&quot; 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 &quot;<b>mkcnvfle.bat</b>&quot;
  53 in the same directory you will find <b>makeconv.c</b>. <b>mkcnvfle</b>
  54 converts all the &quot;.ucm&quot; files in intlwork/data/locales
  55 to &quot;.cnv&quot; 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 &quot;\intlwork\data\locales\&quot;</b>: type in at
  64         the command prompt, &quot;<b>makeconv</b><font
  65         face="Courier"> \intlwork\data\locales\ibm-949.ucm&quot;.
  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         &quot;<b>makeconv</b><font face="Courier"> ibm-949.ucm</font>&quot;.
  71         The tool will try to locate the file &quot;<font
  72         face="Courier">ibm-949.ucm</font>&quot; in the current
  73         directory. The generated binary file, &quot;<font
  74         face="Courier">ibm-949.cnv</font>&quot; 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 &quot;makeconv</font><font size="3"
  82 face="Courier">.dsw</font><font size="3">&quot; workspace project
  83 file in MSVC++ 5.0 compiler.</font> <br>
  84 On Unix the process of building the tool and the &quot;.cnv&quot;
  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 &quot;.ucm&quot;
  89 files in data/locales to &quot;.cnv&quot; 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 &nbsp; </p>
  98 </body>
  99 </html>