Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MAKECONV(1)			 ICU 76.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 convertertable
     file).  This binary file can then be read directly by ICU, or used by  pkg-
     data(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  convertertable  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 start-
     ing with the `#' sign, and ending before the `|' sign, is ignored.   Other-
     wise, 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 in-
     stallation 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 appli-
     cations 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 destina-
	    tion 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 ${pre-
	       fix}/share/icu/76.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
     76.1

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

SEE ALSO
     convrtrs.txt(5)
     pkgdata(1)

ICU MANPAGE			  16 April 2002 		     MAKECONV(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=makeconv&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help