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

FreeBSD Manual Pages

  
 
  

home | help
MAKECONV(1)			ICU 58.2 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-
       vertable	 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 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/58.2/.   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
       58.2

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

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

ICU MANPAGE			 16 April 2002			   MAKECONV(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | CAVEATS | ENVIRONMENT | VERSION | COPYRIGHT | SEE ALSO

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

home | help