2002-01-17 07:04:42 +00:00
|
|
|
.\" Hey, Emacs! This is -*-nroff-*- you know...
|
|
|
|
|
.\"
|
|
|
|
|
.\" gennorm.8: manual page for the gennorm utility
|
|
|
|
|
.\"
|
|
|
|
|
.\" Copyright (C) 2000-2001 IBM, Inc. and others.
|
|
|
|
|
.\"
|
|
|
|
|
.TH GENNORM 8 "16 January 2001" "ICU MANPAGE" "ICU @VERSION@ Manual"
|
|
|
|
|
.SH NAME
|
|
|
|
|
.B gennorm
|
|
|
|
|
\- compile normalization data from the Unicode Character Database
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B gennorm
|
|
|
|
|
[
|
|
|
|
|
.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 gennorm
|
|
|
|
|
reads some of the Unicode Character Database files and compiles their
|
|
|
|
|
normalization information into a binary form.
|
|
|
|
|
The resulting file,
|
|
|
|
|
.BR unorm.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 gennorm
|
|
|
|
|
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
|
2002-01-18 19:45:44 +00:00
|
|
|
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
|
2002-01-17 07:04:42 +00:00
|
|
|
Print help about usage and exit.
|
|
|
|
|
.TP
|
2002-01-18 19:45:44 +00:00
|
|
|
.BR "\-v\fP, \fB\-\-verbose"
|
2002-01-17 07:04:42 +00:00
|
|
|
Display extra informative messages during execution.
|
|
|
|
|
.TP
|
2002-01-17 07:08:26 +00:00
|
|
|
.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
|
2002-01-17 07:04:42 +00:00
|
|
|
.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
|
2002-01-31 04:24:36 +00:00
|
|
|
.BR @thepkgicudatadir@/@PACKAGE@/@VERSION@/ .
|
2002-01-17 07:04:42 +00:00
|
|
|
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 gennorm
|
|
|
|
|
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 DerivedNormalizationProperties.txt
|
|
|
|
|
Derived properties useful in dealing with normalization forms.
|
|
|
|
|
.SH VERSION
|
|
|
|
|
@VERSION@
|
|
|
|
|
.SH COPYRIGHT
|
|
|
|
|
Copyright (C) 2000-2002 IBM, Inc. and others.
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.BR pkgdata (8)
|
