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)