190 lines
4.5 KiB
HTML
190 lines
4.5 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MAKECONV</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MAKECONV</H1>
|
|
Section: ICU 66.1 Manual (1)<BR>Updated: 16 April 2002<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
<B>makeconv</B>
|
|
|
|
- compile a converter table
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>makeconv</B>
|
|
|
|
[
|
|
<B>-h</B>, <B>-?</B>, <B>--help</B>
|
|
|
|
]
|
|
[
|
|
<B>-c</B>, <B>--copyright</B>
|
|
|
|
]
|
|
[
|
|
<B>-v</B>, <B>--verbose</B>
|
|
|
|
]
|
|
[
|
|
<B>-d</B>, <B>--destdir</B><I> destination</I>
|
|
|
|
]
|
|
<I>convertertable</I> ...
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>makeconv</B>
|
|
|
|
converts the ICU converter table
|
|
<I>convertertable</I>
|
|
|
|
into a binary file. The binary file has the same base name as
|
|
<I>convertertable</I>
|
|
|
|
but has a
|
|
<B>.cnv</B>
|
|
|
|
extension (instead of the typical
|
|
<B>.ucm</B>
|
|
|
|
extension of the
|
|
<I>convertertable</I>
|
|
|
|
file).
|
|
This binary file can then be read directly by ICU, or used by
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pkgdata">pkgdata</A></B>(1)
|
|
|
|
for incorporation into a larger archive or library.
|
|
<P>
|
|
|
|
The
|
|
<I>convertertable</I>
|
|
|
|
must be in the ICU ucm (Unicode Codepage Mapping) format in order to
|
|
be understood by
|
|
<B>makeconv</B>.
|
|
|
|
The ICU ucm format is similar to the IBM NLTC upmap/tpmap/rpmap files.
|
|
Comments in the
|
|
<I>convertertable</I>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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
|
|
<B><A HREF="/cgi-bin/man/man2html?5+convrtrs.txt">convrtrs.txt</A></B>(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.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-h</B>, <B>-?</B>, <B>--help</B>
|
|
|
|
<DD>
|
|
Print help about usage and exit.
|
|
<DT id="2"><B>-c</B>, <B>--copyright</B>
|
|
|
|
<DD>
|
|
Include a copyright notice in the binary data.
|
|
<DT id="3"><B>-v</B>, <B>--verbose</B>
|
|
|
|
<DD>
|
|
Display extra informative messages during execution.
|
|
<DT id="4"><B>-d</B>, <B>--destdir</B><I> destination</I>
|
|
|
|
<DD>
|
|
Set the destination directory to
|
|
<I>destination</I>.
|
|
|
|
The default destination directory is specified by the environment variable
|
|
<B>ICU_DATA</B>.
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>CAVEATS</H2>
|
|
|
|
If an existing converter table is changed and recompiled using
|
|
<B>makeconv</B>,
|
|
|
|
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
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pkgdata">pkgdata</A></B>(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.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="5"><B>ICU_DATA</B>
|
|
|
|
<DD>
|
|
Specifies the directory containing ICU data. Defaults to
|
|
<B>${prefix}/share/icu/66.1/</B>.
|
|
|
|
Some tools in ICU depend on the presence of the trailing slash. It is thus
|
|
important to make sure that it is present if
|
|
<B>ICU_DATA</B>
|
|
|
|
is set.
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>VERSION</H2>
|
|
|
|
66.1
|
|
<A NAME="lbAI"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright (C) 2000 IBM, Inc. and others.
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+convrtrs.txt">convrtrs.txt</A></B>(5)
|
|
|
|
<BR>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pkgdata">pkgdata</A></B>(1)
|
|
|
|
<P>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="6"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="7"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="8"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="9"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="10"><A HREF="#lbAF">CAVEATS</A><DD>
|
|
<DT id="11"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="12"><A HREF="#lbAH">VERSION</A><DD>
|
|
<DT id="13"><A HREF="#lbAI">COPYRIGHT</A><DD>
|
|
<DT id="14"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:18 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|