jpayne@68
|
1 .\" Hey, Emacs! This is -*-nroff-*- you know...
|
jpayne@68
|
2 .\"
|
jpayne@68
|
3 .\" gensprep.8: manual page for the gensprep utility
|
jpayne@68
|
4 .\"
|
jpayne@68
|
5 .\" Copyright (C) 2016 and later: Unicode, Inc. and others.
|
jpayne@68
|
6 .\" License & terms of use: http://www.unicode.org/copyright.html
|
jpayne@68
|
7 .\" Copyright (C) 2003 IBM, Inc. and others.
|
jpayne@68
|
8 .\"
|
jpayne@68
|
9 .TH gensprep 8 "18 March 2003" "ICU MANPAGE" "ICU 67.1 Manual"
|
jpayne@68
|
10 .SH NAME
|
jpayne@68
|
11 .B gensprep
|
jpayne@68
|
12 \- compile StringPrep data from files filtered by filterRFC3454.pl
|
jpayne@68
|
13 .SH SYNOPSIS
|
jpayne@68
|
14 .B gensprep
|
jpayne@68
|
15 [
|
jpayne@68
|
16 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
|
jpayne@68
|
17 ]
|
jpayne@68
|
18 [
|
jpayne@68
|
19 .BR "\-v\fP, \fB\-\-verbose"
|
jpayne@68
|
20 ]
|
jpayne@68
|
21 [
|
jpayne@68
|
22 .BI "\-c\fP, \fB\-\-copyright"
|
jpayne@68
|
23 ]
|
jpayne@68
|
24 [
|
jpayne@68
|
25 .BI "\-s\fP, \fB\-\-sourcedir" " source"
|
jpayne@68
|
26 ]
|
jpayne@68
|
27 [
|
jpayne@68
|
28 .BI "\-d\fP, \fB\-\-destdir" " destination"
|
jpayne@68
|
29 ]
|
jpayne@68
|
30 .SH DESCRIPTION
|
jpayne@68
|
31 .B gensprep
|
jpayne@68
|
32 reads filtered RFC 3454 files and compiles their
|
jpayne@68
|
33 information into a binary form.
|
jpayne@68
|
34 The resulting file,
|
jpayne@68
|
35 .BR <name>.icu ,
|
jpayne@68
|
36 can then be read directly by ICU, or used by
|
jpayne@68
|
37 .BR pkgdata (8)
|
jpayne@68
|
38 for incorporation into a larger archive or library.
|
jpayne@68
|
39 .LP
|
jpayne@68
|
40 The files read by
|
jpayne@68
|
41 .B gensprep
|
jpayne@68
|
42 are described in the
|
jpayne@68
|
43 .B FILES
|
jpayne@68
|
44 section.
|
jpayne@68
|
45 .SH OPTIONS
|
jpayne@68
|
46 .TP
|
jpayne@68
|
47 .BR "\-h\fP, \fB\-?\fP, \fB\-\-help"
|
jpayne@68
|
48 Print help about usage and exit.
|
jpayne@68
|
49 .TP
|
jpayne@68
|
50 .BR "\-v\fP, \fB\-\-verbose"
|
jpayne@68
|
51 Display extra informative messages during execution.
|
jpayne@68
|
52 .TP
|
jpayne@68
|
53 .BI "\-c\fP, \fB\-\-copyright"
|
jpayne@68
|
54 Include a copyright notice into the binary data.
|
jpayne@68
|
55 .TP
|
jpayne@68
|
56 .BI "\-s\fP, \fB\-\-sourcedir" " source"
|
jpayne@68
|
57 Set the source directory to
|
jpayne@68
|
58 .IR source .
|
jpayne@68
|
59 The default source directory is specified by the environment variable
|
jpayne@68
|
60 .BR ICU_DATA .
|
jpayne@68
|
61 .TP
|
jpayne@68
|
62 .BI "\-d\fP, \fB\-\-destdir" " destination"
|
jpayne@68
|
63 Set the destination directory to
|
jpayne@68
|
64 .IR destination .
|
jpayne@68
|
65 The default destination directory is specified by the environment variable
|
jpayne@68
|
66 .BR ICU_DATA .
|
jpayne@68
|
67 .SH ENVIRONMENT
|
jpayne@68
|
68 .TP 10
|
jpayne@68
|
69 .B ICU_DATA
|
jpayne@68
|
70 Specifies the directory containing ICU data. Defaults to
|
jpayne@68
|
71 .BR ${prefix}/share/icu/67.1/ .
|
jpayne@68
|
72 Some tools in ICU depend on the presence of the trailing slash. It is thus
|
jpayne@68
|
73 important to make sure that it is present if
|
jpayne@68
|
74 .B ICU_DATA
|
jpayne@68
|
75 is set.
|
jpayne@68
|
76 .SH FILES
|
jpayne@68
|
77 The following files are read by
|
jpayne@68
|
78 .B gensprep
|
jpayne@68
|
79 and are looked for in the
|
jpayne@68
|
80 .I source
|
jpayne@68
|
81 /misc for rfc3454_*.txt files and in
|
jpayne@68
|
82 .I source
|
jpayne@68
|
83 /unidata for NormalizationCorrections.txt.
|
jpayne@68
|
84 .TP 20
|
jpayne@68
|
85 .B rfc3453_A_1.txt
|
jpayne@68
|
86 Contains the list of unassigned codepoints in Unicode version 3.2.0.\|.\|..
|
jpayne@68
|
87 .TP
|
jpayne@68
|
88 .B rfc3454_B_1.txt
|
jpayne@68
|
89 Contains the list of code points that are commonly mapped to nothing.\|.\|..
|
jpayne@68
|
90 .TP
|
jpayne@68
|
91 .B rfc3454_B_2.txt
|
jpayne@68
|
92 Contains the list of mappings for casefolding of code points when Normalization form NFKC is specified.\|.\|..
|
jpayne@68
|
93 .TP
|
jpayne@68
|
94 .B rfc3454_C_X.txt
|
jpayne@68
|
95 Contains the list of code points that are prohibited for IDNA.
|
jpayne@68
|
96 .TP
|
jpayne@68
|
97 .B NormalizationCorrections.txt
|
jpayne@68
|
98 Contains the list of code points whose normalization has changed since Unicode Version 3.2.0.
|
jpayne@68
|
99 .SH VERSION
|
jpayne@68
|
100 67.1
|
jpayne@68
|
101 .SH COPYRIGHT
|
jpayne@68
|
102 Copyright (C) 2000-2002 IBM, Inc. and others.
|
jpayne@68
|
103 .SH SEE ALSO
|
jpayne@68
|
104 .BR pkgdata (8)
|