1
.\" Hey, Emacs! This is -*-nroff-*- you know...
3
.\" makeconv.8: manual page for the makeconv utility
5
.\" Copyright (C) 2000-2002 IBM, Inc. and others.
7
.\" Manual page by Yves Arrouye <yves@realnames.com>.
9
.TH MAKECONV 8 "14 February 2002" "ICU MANPAGE" "ICU @VERSION@ Manual"
12
\- compile a converter table
16
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
19
.BR "\-c\fP, \fB\-\-copyright"
22
.BR "\-v\fP, \fB\-\-verbose"
25
.BI "\-d\fP, \fB\-\-destdir" " destination"
27
.IR convertertable " .\|.\|."
30
converts the ICU converter table
32
into a binary file. The binary file has the same base name as
36
extension (instead of the typical
41
This binary file can then be read directly by ICU, or used by
43
for incorporation into a larger archive or library.
47
must be in the IBM NLTC ucmap format in order to be understood by
51
are handled as follows. If a comment (starting with a `#' sign) that
52
is after some text does contain the fallback indicator `|' then only
53
the text starting with the `#' sign, and ending before the `|' sign,
55
Otherwise, or if the comment is the first thing on the line,
56
the comment runs up to the end of the line. This special
57
handling of comments is to accomodate the practice of putting fallback
58
information in comments in the strict IBM NLTC ucmap format.
60
Note that new converters will be automatically found by ICU after their
61
installation in ICU's data directory. They do not need to
64
converters aliases file in order to be available to applications using ICU.
65
They do need to be listed there if one wants to give them aliases, or
69
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
70
Print help about usage and exit.
72
.BR "\-c\fP, \fB\-\-copyright"
73
Include a copyright notice in the binary data.
75
.BR "\-v\fP, \fB\-\-verbose"
76
Display extra informative messages during execution.
78
.BI "\-d\fP, \fB\-\-destdir" " destination"
79
Set the destination directory to
81
The default destination directory is specified by the environment variable
84
If an existing converter table is changed and recompiled using
86
the resulting binary file must be packaged in the same way that it was
87
packaged initially. For example, if converters were grouped together in
88
an archive or a library with
90
then the archive or library must be rebuilt with the new binary file.
91
A standalone binary converter file will not take precedence over a
96
Specifies the directory containing ICU data. Defaults to
97
.BR @thepkgicudatadir@/@PACKAGE@/@VERSION@/ .
98
Some tools in ICU depend on the presence of the trailing slash. It is thus
99
important to make sure that it is present if
105
Copyright (C) 2000 IBM, Inc. and others.