|
1 .\" Hey, Emacs! This is -*-nroff-*- you know... |
|
2 .\" |
|
3 .\" gencmn.8: manual page for the gencmn utility |
|
4 .\" |
|
5 .\" Copyright (C) 2000-2001 IBM, Inc. and others. |
|
6 .\" |
|
7 .\" Manual page by Yves Arrouye <yves@realnames.com>. |
|
8 .\" |
|
9 .TH GENCMN 8 "5 November 2001" "ICU MANPAGE" "ICU @VERSION@ Manual" |
|
10 .SH NAME |
|
11 .B gencmn |
|
12 \- generate an ICU memory-mappable data file |
|
13 .SH SYNOPSIS |
|
14 .B gencmn |
|
15 [ |
|
16 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help" |
|
17 ] |
|
18 [ |
|
19 .BR "\-v\fP, \fB\-\-verbose" |
|
20 ] |
|
21 [ |
|
22 .BR "\-c\fP, \fB\-\-copyright" |
|
23 | |
|
24 .BI "\-C\fP, \fB\-\-comment" " comment" |
|
25 ] |
|
26 [ |
|
27 .BI "\-d\fP, \fB\-\-destdir" " destination" |
|
28 ] |
|
29 [ |
|
30 .BI "\-n\fP, \fB\-\-name" " name" |
|
31 ] |
|
32 [ |
|
33 .BI "\-t\fP, \fB\-\-type" " fileext" |
|
34 ] |
|
35 [ |
|
36 .BI "\-S\fP, \fB\-\-source" |
|
37 ] |
|
38 [ |
|
39 .BI "\-e\fP, \fB\-\-entrypoint" " name" |
|
40 ] |
|
41 .I maxsize |
|
42 [ |
|
43 .I listfilename |
|
44 ] |
|
45 .SH DESCRIPTION |
|
46 .B gencmn |
|
47 takes a set of files and packages them as an ICU memory-mappable data |
|
48 file. The resulting data file can then be used directly by ICU. |
|
49 .PP |
|
50 .B gencmn |
|
51 reads a list of files to be packaged from either the |
|
52 supplied |
|
53 .I listfilename |
|
54 file, or from its standard output. It packages all the files from |
|
55 the list that are not bigger than |
|
56 .I maxsize |
|
57 bytes, except if |
|
58 .I maxsize |
|
59 is 0, which indicates that there is no size limit on files. |
|
60 .SH OPTIONS |
|
61 .TP |
|
62 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help" |
|
63 Print help about usage and exit. |
|
64 .TP |
|
65 .BR "\-v\fP, \fB\-\-verbose" |
|
66 Display extra informative messages during execution. |
|
67 .TP |
|
68 .BR \-c\fP, \fB\-\-copyright |
|
69 Include the ICU copyright notice in the resulting data. |
|
70 .TP |
|
71 .BI "\-C\fP, \fB\-\-comment" " comment" |
|
72 Include the specified |
|
73 .I comment |
|
74 in the resulting data instead of the ICU copyright notice. |
|
75 .TP |
|
76 .BI "\-d\fP, \fB\-\-destdir" " destination" |
|
77 Set the destination directory to |
|
78 .IR destination . |
|
79 The default destination directory is specified by the environment variable |
|
80 .BR ICU_DATA . |
|
81 .TP |
|
82 .BI "\-n\fP, \fB\-\-name" " name" |
|
83 Set the data name to |
|
84 .I name |
|
85 instead of the default. This name is also used as the base name of the |
|
86 output. The default name is made of the |
|
87 .I icudt |
|
88 prefix, followed by a two-digit version number corresponding to |
|
89 the current version of the ICU release, and a single letter indicating |
|
90 the endianness of the data (the letter |
|
91 .I b |
|
92 indicated big endian data, and the letter |
|
93 .I l |
|
94 indicates little endian ones). |
|
95 .TP |
|
96 .BI "\-t\fP, \fB\-\-type" " type" |
|
97 Use |
|
98 .I type |
|
99 as the type of the data. This type is also used as the extension of |
|
100 the generated data file. The default type ie |
|
101 .IR dat . |
|
102 .TP |
|
103 .BI "\-S\fP, \fB\-\-source" |
|
104 Write a C source file with the table of contents of the data. |
|
105 .TP |
|
106 .BI "\-e\fP, \fB\-\-entrypoint" " name" |
|
107 Set the data entry point (used for linking against the data in a |
|
108 shared library form) to |
|
109 .IR name . |
|
110 The default entry point name is made of the data (set by the |
|
111 .BI "\-n\fP, \fB\-\-name" |
|
112 option) followed by an underscore and the type of the data (set by the |
|
113 .BI "\-t\fP, \fB\-\-type" |
|
114 option). |
|
115 .SH ENVIRONMENT |
|
116 .TP 10 |
|
117 .B ICU_DATA |
|
118 Specifies the directory containing ICU data. Defaults to |
|
119 .BR @thepkgicudatadir@/@PACKAGE@/@VERSION@/ . |
|
120 Some tools in ICU depend on the presence of the trailing slash. It is thus |
|
121 important to make sure that it is present if |
|
122 .B ICU_DATA |
|
123 is set. |
|
124 .SH VERSION |
|
125 @VERSION@ |
|
126 .SH COPYRIGHT |
|
127 Copyright (C) 2000-2001 IBM, Inc. and others. |
|
128 .SH SEE ALSO |
|
129 .BR decmn (8) |