Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022

makeconv (1)


makeconv - compile a converter table


makeconv [ -h, -?, --help ] [ -c, --copyright ] [ -v, --verbose ] [ -d,
--destdir destination ] convertertable ...


MAKECONV(1)                     ICU 69.1 Manual                    MAKECONV(1)

       makeconv - compile a converter table

       makeconv [ -h, -?, --help ] [ -c, --copyright ] [ -v, --verbose ] [ -d,
       --destdir destination ] convertertable ...

       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.

       -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

       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
       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.

       ICU_DATA  Specifies the directory  containing  ICU  data.  Defaults  to
                 ${prefix}/share/icu/69.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.


       Copyright (C) 2000 IBM, Inc. and others.

       See attributes(7) for descriptions of the following attributes:

       |Availability   | developer/icu         |
       |Stability      | Pass-through volatile |


       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source     was     downloaded     from      https://github.com/unicode-

       Further information about this software can be found on the open source
       community website at http://site.icu-project.org/.

ICU MANPAGE                      16 April 2002                     MAKECONV(1)