| .\" Hey, Emacs! This is -*-nroff-*- you know... |
| .\" |
| .\" genprops.8: manual page for the genprops utility |
| .\" |
| .\" Copyright (C) 2000-2001 IBM, Inc. and others. |
| .\" |
| .TH GENPROPS 8 "16 January 2001" "ICU MANPAGE" "ICU @VERSION@ Manual" |
| .SH NAME |
| .B genprops |
| \- compile properties from the Unicode Character Database |
| .SH SYNOPSIS |
| .B genprops |
| [ |
| .BR "\-h\fP, \fB\-?\fP, \fB\-\-help" |
| ] |
| [ |
| .BR "\-v\fP, \fB\-\-verbose" |
| ] |
| [ |
| .BI "\-u\fP, \fB\-\-unicode" " version" |
| ] |
| [ |
| .BI "\-c\fP, \fB\-\-copyright" |
| ] |
| [ |
| .BI "\-s\fP, \fB\-\-sourcedir" " source" |
| ] |
| [ |
| .BI "\-d\fP, \fB\-\-destdir" " destination" |
| ] |
| [ |
| .I suffix |
| ] |
| .SH DESCRIPTION |
| .B genprops |
| reads some of the Unicode Character Database files and compiles their |
| information information into a binary form. |
| The resulting file, |
| .BR icudata.dat , |
| can then be read directly by ICU, or used by |
| .BR pkgdata (8) |
| for incorporation into a larger archive or library. |
| .LP |
| The files read by |
| .B genprops |
| are described in the |
| .B FILES |
| section. If |
| .I suffix |
| is passed on the command line, the names of these files will actually |
| be changed to include a dash followed by |
| .I suffix |
| in their basename. For example, the file |
| .B UnicodeData.txt |
| would be looked for under the name |
| .BR UnicodeData\-\fIsuffix\fP.txt . |
| .SH OPTIONS |
| .TP |
| .BR "\-h\fP, \fB\-?\fP, \fB\-\-help" |
| Print help about usage and exit. |
| .TP |
| .BR "\-v\fP, \fB\-\-verbose" |
| Display extra informative messages during execution. |
| .TP |
| .BI "\-u\fP, \fB\-\-unicode" " version" |
| Specify which |
| .I version |
| of Unicode the Unicode Character Database refers to. |
| Defaults to |
| .BR 3.0.0 . |
| .TP |
| .BI "\-c\fP, \fB\-\-copyright" |
| Include a copyright notice into the binary data. |
| .TP |
| .BI "\-s\fP, \fB\-\-sourcedir" " source" |
| Set the source directory to |
| .IR source . |
| The default source directory is specified by the environment variable |
| .BR ICU_DATA . |
| .TP |
| .BI "\-d\fP, \fB\-\-destdir" " destination" |
| Set the destination directory to |
| .IR destination . |
| The default destination directory is specified by the environment variable |
| .BR ICU_DATA . |
| .SH ENVIRONMENT |
| .TP 10 |
| .B ICU_DATA |
| Specifies the directory containing ICU data. Defaults to |
| .BR @thepkgicudatadir@/@PACKAGE@/@VERSION@/ . |
| 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 |
| is set. |
| .SH FILES |
| The following files are read by |
| .B genprops |
| and are looked for in the |
| .I source |
| directory. |
| .TP 20 |
| .B UnicodeData.txt |
| The main file in the Unicode Character Database. Contains character |
| properties, combining classes information, decompositions, names, |
| etc.\|.\|.. |
| .TP |
| .B BidiMirroring.txt |
| Properties for substituting characters in an implementation of |
| bidirectional mirroring. |
| .TP |
| .B SpecialCasing.txt |
| List of properties required for full case mapping. |
| .TP |
| .B CaseFolding.txt |
| Mapping from characters to their case-folded forms. (Note: this file |
| is derived from |
| .B UnicodeData.txt |
| and |
| .B SpecialCasing.txt |
| when generated by the Unicode Consortium.) |
| .SH VERSION |
| @VERSION@ |
| .SH COPYRIGHT |
| Copyright (C) 2000-2002 IBM, Inc. and others. |
| .SH SEE ALSO |
| .BR pkgdata (8) |