MAKECONV(1) ICU 67.1 Manual MAKECONV(1)
NAME
makeconv - compile a converter table
SYNOPSIS
makeconv [ -h, -?, --help ] [ -c, --copyright ] [ -v, --verbose ] [ -d,
--destdir destination ] convertertable ...
DESCRIPTION
makeconv converts the ICU converter table convertertable into a binary
file. The binary file has the same base name as convertertable but has
a .cnv extension (instead of the typical .ucm extension of the convert-
ertable file). This binary file can then be read directly by ICU, or
used by pkgdata(1) for incorporation into a larger archive or library.
The convertertable must be in the ICU ucm (Unicode Codepage Mapping)
format in order to be understood by makeconv. The ICU ucm format is
similar to the IBM NLTC upmap/tpmap/rpmap files. Comments in the con-
vertertable are handled as follows. If a comment (starting with a `#'
sign) that is after some text does contain the fallback indicator `|'
then only the text starting with the `#' sign, and ending before the
`|' sign, is ignored. Otherwise, or if the comment is the first thing
on the line, the comment runs up to the end of the line. This special
handling of comments is to accommodate the practice of putting fallback
information in comments in the strict IBM NLTC ucmap format.
Note that new converters will be automatically found by ICU after their
installation in ICU's data directory. They do not need to be listed in
the convrtrs.txt(5) converters aliases file in order to be available to
applications using ICU. They do need to be listed there if one wants
to give them aliases, or tags, though.
OPTIONS
-h, -?, --help
Print help about usage and exit.
-c, --copyright
Include a copyright notice in the binary data.
-v, --verbose
Display extra informative messages during execution.
-d, --destdir destination
Set the destination directory to destination. The default des-
tination directory is specified by the environment variable
ICU_DATA.
CAVEATS
If an existing converter table is changed and recompiled using make-
conv, the resulting binary file must be packaged in the same way that
it was packaged initially. For example, if converters were grouped to-
gether in an archive or a library with pkgdata(1), then the archive or
library must be rebuilt with the new binary file. A standalone binary
converter file will not take precedence over a packaged one.
ENVIRONMENT
ICU_DATA Specifies the directory containing ICU data. Defaults to
${prefix}/share/icu/67.1/. Some tools in ICU depend on the
presence of the trailing slash. It is thus important to make
sure that it is present if ICU_DATA is set.
VERSION
67.1
COPYRIGHT
Copyright (C) 2000 IBM, Inc. and others.
SEE ALSO
convrtrs.txt(5)pkgdata(1)
ICU MANPAGE 16 April 2002 MAKECONV(1)