README
1Unicode/Normalize version 0.28
2===================================
3
4Unicode::Normalize - Unicode Normalization Forms
5
6SYNOPSIS
7
8 use Unicode::Normalize;
9
10 $NFD_string = NFD($string); # Normalization Form D
11 $NFC_string = NFC($string); # Normalization Form C
12 $NFKD_string = NFKD($string); # Normalization Form KD
13 $NFKC_string = NFKC($string); # Normalization Form KC
14
15 or
16
17 use Unicode::Normalize 'normalize';
18
19 $NFD_string = normalize('D', $string); # Normalization Form D
20 $NFC_string = normalize('C', $string); # Normalization Form C
21 $NFKD_string = normalize('KD', $string); # Normalization Form KD
22 $NFKC_string = normalize('KC', $string); # Normalization Form KC
23
24
25INSTALLATION
26
27Perl 5.6.1 or later.
28(Perl 5.8.0 or later is recommended.)
29
30To install this module (XSUB: needs a C compiler), type the following:
31
32 perl Makefile.PL
33 make
34 make test
35 make install
36
37If you want to install pure Perl (i.e. no-XSUB),
38type the following (!! "disableXS" must run before "Makefile.PL" !!):
39
40 perl disableXS
41 perl Makefile.PL
42 make
43 make test
44 make install
45
46After building no-XSUB, if you decide to install XSUB,
47type the following (!! "enableXS" must run before "Makefile.PL" !!):
48
49 make clean
50 perl enableXS
51 perl Makefile.PL
52 make
53 make test
54 make install
55
56DEPENDENCIES
57
58This module requires other modules and libraries following:
59
60Carp
61Exporter
62File::Copy
63File::Spec
64
65unicore/CombiningClass.pl (or unicode/CombiningClass.pl)
66unicore/Decomposition.pl (or unicode/Decomposition.pl)
67unicore/CompositionExclusions.txt (or unicode/CompExcl.txt)
68
69CAVEAT
70
71(1) In the perl-current, unicore/CompExcl.txt
72 is renamed unicore/CompositionExclusions.txt.
73
74(2) After these unicore/*.* files are updated.
75
76 In the case of an XS edition:
77 You must rebuild the module,
78 as the data will be compiled on building.
79
80 In the case of a pure Perl edition:
81 Rebuilding is not necessary,
82 as the data will be read on requirement.
83
84(3) Pure Perl edition, Normalize.pmN, may work without any other file
85 in this distribution (it must be renamed Normalize.pm, though)
86
87COPYRIGHT AND LICENCE
88
89 SADAHIRO Tomoyuki <SADAHIRO@cpan.org>
90
91 http://homepage1.nifty.com/nomenclator/perl/
92
93 Copyright(C) 2001-2003, SADAHIRO Tomoyuki. Japan. All rights reserved.
94
95 This module is free software; you can redistribute it
96 and/or modify it under the same terms as Perl itself.
97