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
convertertable 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
convertable 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 accomodate 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
destination directory is specified by the environment variable
ICU_DATA.
CAVEATS¶
If an existing converter table is changed and recompiled using
makeconv,
the resulting binary file must be packaged in the same way that it was
packaged initially. For example, if converters were grouped together 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/52.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¶
52.1
COPYRIGHT¶
Copyright (C) 2000 IBM, Inc. and others.
SEE ALSO¶
convrtrs.txt(5)
pkgdata(1)