1 .\" Hey, Emacs! This is -*-nroff-*- you know...
3 .\" genrb.1: manual page for the genrb utility
5 .\" Copyright (C) 2016 and later: Unicode, Inc. and others.
6 .\" License & terms of use: http://www.unicode.org/copyright.html
7 .\" Copyright (C) 2000-2002 IBM, Inc. and others.
9 .\" Manual page by Yves Arrouye <yves@realnames.com>.
11 .TH GENRB 1 "16 April 2002" "ICU MANPAGE" "ICU @VERSION@ Manual"
14 \- compile a resource bundle
18 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
21 .BR "\-V\fP, \fB\-\-version"
24 .BR "\-v\fP, \fB\-\-verbose"
27 .BI "\-e\fP, \fB\-\-encoding" " encoding"
30 .BI "\-j\fP, \fB\-\-write\-java" " \fR[ \fPencoding\fR ]\fP"
33 .BI "\-s\fP, \fB\-\-sourcedir" " source"
36 .BI "\-d\fP, \fB\-\-destdir" " destination"
39 .BI "\-i\fP, \fB\-\-icudatadir" " directory"
46 source files passed on the command line to their binary form or to
47 a Java source file for use with ICU4J.
48 The resulting binary files have a
50 extension while resource bundle source files typically have a
52 extension. Java source files have a
54 extension and follow the ICU4J naming conventions.
56 It is customary to name the resource bundles by their locale name,
57 i.e. to use a local identifier for the
61 for Japanese (Japan) data, or
66 will produce a file whose base name is the name of the locale found
67 in the resource file, not the base name of the resource file itself.
69 The binary files can be read directly by ICU, or used by
71 for incorporation into a larger archive or library.
74 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
75 Print help about usage and exit.
77 .BR "\-V\fP, \fB\-\-version"
82 .BR "\-v\fP, \fB\-\-verbose"
83 Display extra informative messages during execution.
85 .BI "\-e\fP, \fB\-\-encoding" " encoding"
86 Set the encoding used to read input files to
88 The default encoding is the invariant (subset of ASCII or EBCDIC)
89 codepage for the system (see section
90 .BR "INVARIANT CHARACTERS" ).
91 The encodings UTF-8, UTF-16BE, and UTF-16LE are automatically detected
92 if a byte order mark (BOM) is present.
94 .BI "\-j\fP, \fB\-\-write\-java" " \fR[ \fPencoding\fR ]\fP"
95 Generate a Java source code for use with ICU4J. An optional
97 for the Java file can be given.
99 .BI "\-s\fP, \fB\-\-sourcedir" " source"
100 Set the source directory to
102 The default source directory is specified by the environment variable
104 or the location set when ICU was built if
108 .BI "\-d\fP, \fB\-\-destdir" " destination"
109 Set the destination directory to
111 The default destination directory is specified by the environment variable
113 or is the location set when ICU was built if
117 .BI "\-i\fP, \fB\-\-icudatadir" " directory"
118 Look for any necessary ICU data files in
120 For example, when processing collation overrides, the file
123 The default ICU data directory is specified by the environment variable
125 .SH INVARIANT CHARACTERS
127 .B invariant character set
128 consists of the following set of characters, expressed as a standard POSIX
130 .BR "[a-z]|[A-Z]|[0-9]|_| |+|-|*|/" .
131 This is the set which is guaranteed to be available regardless of code page.
135 Specifies the directory containing ICU data. Defaults to
136 .BR @thepkgicudatadir@/@PACKAGE@/@VERSION@/ .
137 Some tools in ICU depend on the presence of the trailing slash. It is thus
138 important to make sure that it is present if
144 Copyright (C) 2000-2002 IBM, Inc. and others.