← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/icu/gutsy-updates

« back to all changes in this revision

Viewing changes to source/tools/makeconv/readme.htm

  • Committer: Package Import Robot
  • Author(s): Jay Berkenbilt
  • Date: 2005-11-19 11:29:31 UTC
  • mfrom: (1.1.2)
  • Revision ID: package-import@ubuntu.com-20051119112931-vcizkrp10tli4enw
Tags: 3.4-3
Explicitly build with g++ 3.4.  The current ICU fails its test suite
with 4.0 but not with 3.4.  Future versions should work properly with
4.0.

Show diffs side-by-side

added added

removed removed

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