man-pages/man1/genrb.1.html
2021-03-31 01:06:50 +01:00

242 lines
5.0 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of GENRB</TITLE>
</HEAD><BODY>
<H1>GENRB</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">&nbsp;</A>
<H2>NAME</H2>
<B>genrb</B>
- compile a resource bundle
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>genrb</B>
[
<B>-h</B>, <B>-?</B>, <B>--help</B>
]
[
<B>-V</B>, <B>--version</B>
]
[
<B>-v</B>, <B>--verbose</B>
]
[
<B>-e</B>, <B>--encoding</B><I> encoding</I>
]
[
<B>-j</B>, <B>--write-java</B><I> </I>[ encoding ]
]
[
<B>-s</B>, <B>--sourcedir</B><I> source</I>
]
[
<B>-d</B>, <B>--destdir</B><I> destination</I>
]
[
<B>-i</B>, <B>--icudatadir</B><I> directory</I>
]
<I>bundle</I> ...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>genrb</B>
converts the resource
<I>bundle</I>
source files passed on the command line to their binary form or to
a Java source file for use with ICU4J.
The resulting binary files have a
<B>.res</B>
extension while resource bundle source files typically have a
<B>.txt</B>
extension. Java source files have a
<B>java</B>
extension and follow the ICU4J naming conventions.
<P>
It is customary to name the resource bundles by their locale name,
i.e. to use a local identifier for the
<I>bundle</I>
filename, e.g.
<B>ja_JP.txt</B>
for Japanese (Japan) data, or
<B>root.txt</B>
for the root bundle.
In any case,
<B>genrb</B>
will produce a file whose base name is the name of the locale found
in the resource file, not the base name of the resource file itself.
<P>
The binary files can 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.
<A NAME="lbAE">&nbsp;</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>-V</B>, <B>--version</B>
<DD>
Print the version of
<B>genrb</B>
and exit.
<DT id="3"><B>-v</B>, <B>--verbose</B>
<DD>
Display extra informative messages during execution.
<DT id="4"><B>-e</B>, <B>--encoding</B><I> encoding</I>
<DD>
Set the encoding used to read input files to
<I>encoding</I>.
The default encoding is the invariant (subset of ASCII or EBCDIC)
codepage for the system (see section
<B>INVARIANT CHARACTERS</B>).
The encodings UTF-8, UTF-16BE, and UTF-16LE are automatically detected
if a byte order mark (BOM) is present.
<DT id="5"><B>-j</B>, <B>--write-java</B><I> </I>[ encoding ]
<DD>
Generate a Java source code for use with ICU4J. An optional
<I>encoding</I>
for the Java file can be given.
<DT id="6"><B>-s</B>, <B>--sourcedir</B><I> source</I>
<DD>
Set the source directory to
<I>source</I>.
The default source directory is specified by the environment variable
<B>ICU_DATA</B>,
or the location set when ICU was built if
<B>ICU_DATA</B>
is not set.
<DT id="7"><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>
or is the location set when ICU was built if
<B>ICU_DATA</B>
is not set.
<DT id="8"><B>-i</B>, <B>--icudatadir</B><I> directory</I>
<DD>
Look for any necessary ICU data files in
<I>directory</I>.
For example, when processing collation overrides, the file
<B>ucadata.dat</B>
must be located.
The default ICU data directory is specified by the environment variable
<B>ICU_DATA</B>.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>INVARIANT CHARACTERS</H2>
The
<B>invariant character set</B>
consists of the following set of characters, expressed as a standard POSIX
regular expression:
<B>[a-z]|[A-Z]|[0-9]|_| |+|-|*|/</B>.
This is the set which is guaranteed to be available regardless of code page.
<A NAME="lbAG">&nbsp;</A>
<H2>ENVIRONMENT</H2>
<DL COMPACT>
<DT id="9"><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">&nbsp;</A>
<H2>VERSION</H2>
66.1
<A NAME="lbAI">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright (C) 2000-2002 IBM, Inc. and others.
<A NAME="lbAJ">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+derb">derb</A></B>(1)
<BR>
<B><A HREF="/cgi-bin/man/man2html?1+pkgdata">pkgdata</A></B>(1)
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="10"><A HREF="#lbAB">NAME</A><DD>
<DT id="11"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="12"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="13"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="14"><A HREF="#lbAF">INVARIANT CHARACTERS</A><DD>
<DT id="15"><A HREF="#lbAG">ENVIRONMENT</A><DD>
<DT id="16"><A HREF="#lbAH">VERSION</A><DD>
<DT id="17"><A HREF="#lbAI">COPYRIGHT</A><DD>
<DT id="18"><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:13 GMT, March 31, 2021
</BODY>
</HTML>