~ubuntu-branches/ubuntu/gutsy/icu/gutsy-updates

« back to all changes in this revision

Viewing changes to source/tools/gennorm/gennorm.8.in

  • Committer: Package Import Robot
  • Author(s): Jay Berkenbilt
  • Date: 2005-11-19 11:29:31 UTC
  • mfrom: (1.1.2)
  • Revision ID: package-import@ubuntu.com-20051119112931-vcizkrp10tli4enw
Tags: 3.4-3
Explicitly build with g++ 3.4.  The current ICU fails its test suite
with 4.0 but not with 3.4.  Future versions should work properly with
4.0.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" Hey, Emacs! This is -*-nroff-*- you know...
2
 
.\"
3
 
.\" gennorm.8: manual page for the gennorm utility
4
 
.\"
5
 
.\" Copyright (C) 2000-2001 IBM, Inc. and others.
6
 
.\"
7
 
.TH GENNORM 8 "16 January 2001" "ICU MANPAGE" "ICU @VERSION@ Manual"
8
 
.SH NAME
9
 
.B gennorm
10
 
\- compile normalization data from the Unicode Character Database
11
 
.SH SYNOPSIS
12
 
.B gennorm
13
 
[
14
 
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
15
 
]
16
 
[
17
 
.BR "\-v\fP, \fB\-\-verbose"
18
 
]
19
 
[
20
 
.BI "\-u\fP, \fB\-\-unicode" " version"
21
 
]
22
 
[
23
 
.BI "\-c\fP, \fB\-\-copyright"
24
 
]
25
 
[
26
 
.BI "\-s\fP, \fB\-\-sourcedir" " source"
27
 
]
28
 
[
29
 
.BI "\-d\fP, \fB\-\-destdir" " destination"
30
 
]
31
 
[
32
 
.I suffix
33
 
]
34
 
.SH DESCRIPTION
35
 
.B gennorm
36
 
reads some of the Unicode Character Database files and compiles their
37
 
normalization information into a binary form.
38
 
The resulting file,
39
 
.BR unorm.dat ,
40
 
can then be read directly by ICU, or used by
41
 
.BR pkgdata (8)
42
 
for incorporation into a larger archive or library.
43
 
.LP
44
 
The files read by
45
 
.B gennorm
46
 
are described in the
47
 
.B FILES
48
 
section. If
49
 
.I suffix
50
 
is passed on the command line, the names of these files will actually
51
 
be changed to include a dash followed by
52
 
.I suffix
53
 
in their basename. For example, the file
54
 
.B UnicodeData.txt
55
 
would be looked for under the name
56
 
.BR UnicodeData\-\fIsuffix\fP.txt .
57
 
.SH OPTIONS
58
 
.TP
59
 
.BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
60
 
Print help about usage and exit.
61
 
.TP
62
 
.BR "\-v\fP, \fB\-\-verbose"
63
 
Display extra informative messages during execution.
64
 
.TP
65
 
.BI "\-u\fP, \fB\-\-unicode" " version"
66
 
Specify which
67
 
.I  version
68
 
of Unicode the Unicode Character Database refers to.
69
 
Defaults to
70
 
.BR  3.0.0 .
71
 
.TP
72
 
.BI "\-c\fP, \fB\-\-copyright"
73
 
Include a copyright notice into the binary data.
74
 
.TP
75
 
.BI "\-s\fP, \fB\-\-sourcedir" " source"
76
 
Set the source directory to
77
 
.IR source .
78
 
The default source directory is specified by the environment variable
79
 
.BR ICU_DATA .
80
 
.TP
81
 
.BI "\-d\fP, \fB\-\-destdir" " destination"
82
 
Set the destination directory to
83
 
.IR destination .
84
 
The default destination directory is specified by the environment variable
85
 
.BR ICU_DATA .
86
 
.SH ENVIRONMENT
87
 
.TP 10
88
 
.B ICU_DATA
89
 
Specifies the directory containing ICU data. Defaults to
90
 
.BR @thepkgicudatadir@/@PACKAGE@/@VERSION@/ .
91
 
Some tools in ICU depend on the presence of the trailing slash. It is thus
92
 
important to make sure that it is present if
93
 
.B ICU_DATA
94
 
is set.
95
 
.SH FILES
96
 
The following files are read by
97
 
.B gennorm
98
 
and are looked for in the
99
 
.I source
100
 
directory.
101
 
.TP 20
102
 
.B UnicodeData.txt
103
 
The main file in the Unicode Character Database. Contains character
104
 
properties, combining classes information, decompositions, names,
105
 
etc.\|.\|.. 
106
 
.TP
107
 
.B DerivedNormalizationProperties.txt
108
 
Derived properties useful in dealing with normalization forms.
109
 
.SH VERSION
110
 
@VERSION@
111
 
.SH COPYRIGHT
112
 
Copyright (C) 2000-2002 IBM, Inc. and others.
113
 
.SH SEE ALSO
114
 
.BR pkgdata (8)