316 lines
6.2 KiB
HTML
316 lines
6.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of DERB</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>DERB</H1>
|
|
Section: ICU 66.1 Manual (1)<BR>Updated: 7 Mar 2014<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>derb</B>
|
|
|
|
- disassemble a resource bundle
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>derb</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>--bom</B>
|
|
|
|
]
|
|
[
|
|
<B>-t</B>, <B>--truncate</B><I> </I>[ size ]
|
|
|
|
]
|
|
[
|
|
<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>
|
|
|
|
]
|
|
[
|
|
<B>-c</B>, <B>--to-stdout</B>
|
|
|
|
]
|
|
<I>bundle</I> ...
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>derb</B>
|
|
|
|
reads the compiled resource
|
|
<I>bundle</I>
|
|
|
|
files passed on the command line and write them back in text form.
|
|
The resulting text files have a
|
|
<B>.txt</B>
|
|
|
|
extension while compiled resource bundle source files typically have a
|
|
<B>.res</B>
|
|
|
|
extension.
|
|
<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.res</B>
|
|
|
|
for Japanese (Japan) data, or
|
|
<B>root.res</B>
|
|
|
|
for the root bundle.
|
|
This is especially important for
|
|
<B>derb</B>
|
|
|
|
since the locale name is not accessible directly from the compiled
|
|
resource bundle, and to know which locale to ask for when opening
|
|
the bundle.
|
|
<B>derb</B>
|
|
|
|
will produce a file whose base name is the base name of the compiled resource file itself.
|
|
If the
|
|
<B>--to-stdout</B>, <B>-c</B>
|
|
|
|
option is used, however, the text will be written on the standard output.
|
|
<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>-V</B>, <B>--version</B>
|
|
|
|
<DD>
|
|
Print the version of
|
|
<B>derb</B>
|
|
|
|
and exit.
|
|
<DT id="3"><B>-v</B>, <B>--verbose</B>
|
|
|
|
<DD>
|
|
Display extra informative messages during execution.
|
|
<DT id="4"><B>-A</B>, <B>--suppressAliases</B>
|
|
|
|
<DD>
|
|
Don't follow aliases when producing output.
|
|
<DT id="5"><B>-e</B>, <B>--encoding</B><I> encoding</I>
|
|
|
|
<DD>
|
|
Set the encoding used to write output 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 choice of the encoding does not affect the data, just their
|
|
representation. Characters that cannot be represented in the
|
|
<I>encoding</I>
|
|
|
|
will be represented using
|
|
<B>\u</B><I>hhhh</I>
|
|
|
|
escape sequences.
|
|
<DT id="6"><B>--bom</B>
|
|
|
|
<DD>
|
|
Write a byte order mark (BOM) at the beginning of the file.
|
|
<DT id="7"><B>-l</B>, <B>--locale</B><I> locale</I>
|
|
|
|
<DD>
|
|
Set the
|
|
<I>locale</I>
|
|
|
|
for the resource bundle, which is used both in the generated text and
|
|
as the base name of the output file.
|
|
<DT id="8"><B>-t</B>, <B>--truncate</B><I> </I>[ size ]
|
|
|
|
<DD>
|
|
Truncate individual resources (strings or binary data) to
|
|
<I>size</I>
|
|
|
|
bytes. The default if
|
|
<I>size</I>
|
|
|
|
is not specified is
|
|
<B>80</B>
|
|
|
|
bytes.
|
|
<DT id="9"><B>-s</B>, <B>--sourcedir</B><I> source</I>
|
|
|
|
<DD>
|
|
Set the source directory to
|
|
<I>source</I>.
|
|
|
|
The default source directory is the current directory.
|
|
If
|
|
<B>-</B>
|
|
|
|
is passed for
|
|
<I>source</I>,
|
|
|
|
then the
|
|
<I>bundle</I>
|
|
|
|
will be looked for in its default location, specified by
|
|
the
|
|
<B>ICU_DATA</B>
|
|
|
|
environment variable (or defaulting to
|
|
the location set when ICU was built if
|
|
<B>ICU_DATA</B>
|
|
|
|
is not set).
|
|
<DT id="10"><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="11"><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>.
|
|
|
|
<DT id="12"><B>-c</B>, <B>--to-stdout</B>
|
|
|
|
<DD>
|
|
Write the disassembled
|
|
<I>bundle</I>
|
|
|
|
on standard output instead of into a file.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>CAVEATS</H2>
|
|
|
|
When the option
|
|
<B>--bom</B>
|
|
|
|
is used, the character
|
|
<B>U+FEFF</B>
|
|
|
|
is written in the destination
|
|
<I>encoding</I>
|
|
|
|
regardless of whether it is a Unicode transformation format (UTF) or not.
|
|
This option should only be used with an UTF encoding, as byte order marks
|
|
are not meaningful for other encodings.
|
|
<A NAME="lbAG"> </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="lbAH"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="13"><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="lbAI"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Vladimir Weinstein
|
|
<BR>
|
|
|
|
Yves Arrouye
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>VERSION</H2>
|
|
|
|
1.0
|
|
<A NAME="lbAK"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright (C) 2002 IBM, Inc. and others.
|
|
<A NAME="lbAL"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+genrb">genrb</A></B>(1)
|
|
|
|
<P>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="14"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="15"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="16"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="17"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="18"><A HREF="#lbAF">CAVEATS</A><DD>
|
|
<DT id="19"><A HREF="#lbAG">INVARIANT CHARACTERS</A><DD>
|
|
<DT id="20"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="21"><A HREF="#lbAI">AUTHORS</A><DD>
|
|
<DT id="22"><A HREF="#lbAJ">VERSION</A><DD>
|
|
<DT id="23"><A HREF="#lbAK">COPYRIGHT</A><DD>
|
|
<DT id="24"><A HREF="#lbAL">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:10 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|