genrb(1) - f37

1GENRB(1)                        ICU 71.1 Manual                       GENRB(1)
2
3
4

NAME

6       genrb - compile a resource bundle
7

SYNOPSIS

9       genrb  [  -h,  -?,  --help  ] [ -V, --version ] [ -v, --verbose ] [ -e,
10       --encoding encoding  ]  [  -j,  --write-java  [  encoding  ]  ]  [  -s,
11       --sourcedir  source  ] [ -d, --destdir destination ] [ -i, --icudatadir
12       directory ] bundle ...
13

DESCRIPTION

15       genrb converts the resource bundle source files passed on  the  command
16       line  to their binary form or to a Java source file for use with ICU4J.
17       The resulting binary files have a .res extension while resource  bundle
18       source  files typically have a .txt extension. Java source files have a
19       java extension and follow the ICU4J naming conventions.
20
21       It is customary to name the resource bundles by their locale name, i.e.
22       to  use a local identifier for the bundle filename, e.g.  ja_JP.txt for
23       Japanese (Japan) data, or root.txt for the root bundle.  In  any  case,
24       genrb  will  produce  a  file whose base name is the name of the locale
25       found in the resource file, not the base name of the resource file  it‐
26       self.
27
28       The binary files can be read directly by ICU, or used by pkgdata(1) for
29       incorporation into a larger archive or library.
30

OPTIONS

32       -h, -?, --help
33              Print help about usage and exit.
34
35       -V, --version
36              Print the version of genrb and exit.
37
38       -v, --verbose
39              Display extra informative messages during execution.
40
41       -e, --encoding encoding
42              Set the encoding used to read input files to encoding.  The  de‐
43              fault  encoding  is  the  invariant  (subset of ASCII or EBCDIC)
44              codepage for the system (see section INVARIANT CHARACTERS).  The
45              encodings  UTF-8,  UTF-16BE,  and UTF-16LE are automatically de‐
46              tected if a byte order mark (BOM) is present.
47
48       -j, --write-java [ encoding ]
49              Generate a Java source code for use with ICU4J. An optional  en‐
50              coding for the Java file can be given.
51
52       -s, --sourcedir source
53              Set  the  source directory to source.  The default source direc‐
54              tory is specified by the environment variable ICU_DATA,  or  the
55              location set when ICU was built if ICU_DATA is not set.
56
57       -d, --destdir destination
58              Set  the destination directory to destination.  The default des‐
59              tination directory is  specified  by  the  environment  variable
60              ICU_DATA  or  is the location set when ICU was built if ICU_DATA
61              is not set.
62
63       -i, --icudatadir directory
64              Look for any necessary ICU data files in directory.   For  exam‐
65              ple,  when  processing collation overrides, the file ucadata.dat
66              must be located.  The default ICU data directory is specified by
67              the environment variable ICU_DATA.
68

INVARIANT CHARACTERS

70       The  invariant  character  set consists of the following set of charac‐
71       ters, expressed as  a  standard  POSIX  regular  expression:  [a-z]|[A-
72       Z]|[0-9]|_| |+|-|*|/.  This is the set which is guaranteed to be avail‐
73       able regardless of code page.
74

ENVIRONMENT

76       ICU_DATA  Specifies the directory  containing  ICU  data.  Defaults  to
77                 /usr/share/icu/71.1/.   Some tools in ICU depend on the pres‐
78                 ence of the trailing slash. It is thus important to make sure
79                 that it is present if ICU_DATA is set.
80

VERSION

82       71.1
83

COPYRIGHT

85       Copyright (C) 2000-2002 IBM, Inc. and others.
86