Commit | Line | Data |
---|---|---|
51683ce6 | 1 | Unicode/Normalize version 1.03 |
45394607 JH |
2 | =================================== |
3 | ||
f027f502 | 4 | Unicode::Normalize - Unicode Normalization Forms |
45394607 JH |
5 | |
6 | SYNOPSIS | |
7 | ||
39f4556f RGS |
8 | (1) using function names exported by default: |
9 | ||
45394607 JH |
10 | use Unicode::Normalize; |
11 | ||
8f118dcd JH |
12 | $NFD_string = NFD($string); # Normalization Form D |
13 | $NFC_string = NFC($string); # Normalization Form C | |
14 | $NFKD_string = NFKD($string); # Normalization Form KD | |
15 | $NFKC_string = NFKC($string); # Normalization Form KC | |
16 | ||
39f4556f | 17 | (2) using function names exported on request: |
45394607 | 18 | |
45394607 JH |
19 | use Unicode::Normalize 'normalize'; |
20 | ||
8f118dcd JH |
21 | $NFD_string = normalize('D', $string); # Normalization Form D |
22 | $NFC_string = normalize('C', $string); # Normalization Form C | |
23 | $NFKD_string = normalize('KD', $string); # Normalization Form KD | |
24 | $NFKC_string = normalize('KC', $string); # Normalization Form KC | |
25 | ||
45394607 JH |
26 | INSTALLATION |
27 | ||
39f4556f RGS |
28 | Perl 5.6.1 or later is required. |
29 | Perl 5.8.1 or later is recommended. | |
ac5ea531 | 30 | |
82e740b6 | 31 | To install this module (XSUB: needs a C compiler), type the following: |
45394607 JH |
32 | |
33 | perl Makefile.PL | |
34 | make | |
35 | make test | |
36 | make install | |
37 | ||
82e740b6 NC |
38 | If you want to install pure Perl (i.e. no-XSUB), |
39 | type the following (!! "disableXS" must run before "Makefile.PL" !!): | |
ac5ea531 | 40 | |
82e740b6 NC |
41 | perl disableXS |
42 | perl Makefile.PL | |
ac5ea531 JH |
43 | make |
44 | make test | |
45 | make install | |
46 | ||
82e740b6 NC |
47 | After building no-XSUB, if you decide to install XSUB, |
48 | type the following (!! "enableXS" must run before "Makefile.PL" !!): | |
ab8fe378 JH |
49 | |
50 | make clean | |
82e740b6 NC |
51 | perl enableXS |
52 | perl Makefile.PL | |
ab8fe378 JH |
53 | make |
54 | make test | |
55 | make install | |
56 | ||
45394607 JH |
57 | DEPENDENCIES |
58 | ||
39f4556f RGS |
59 | This module requires some core modules and pragmas, |
60 | and the following files from Unicode Character Database, | |
61 | which are included in recent perl core distributions. | |
45394607 | 62 | |
39f4556f RGS |
63 | - unicore/CombiningClass.pl (or unicode/CombiningClass.pl) |
64 | - unicore/Decomposition.pl (or unicode/Decomposition.pl) | |
65 | - unicore/CompositionExclusions.txt (or unicode/CompExcl.txt) | |
ab8fe378 | 66 | |
2b8d773d | 67 | NOTES |
ab8fe378 | 68 | |
39f4556f | 69 | (1) After these unicore/*.* files are updated: |
ab8fe378 | 70 | |
39f4556f | 71 | In the case of XSUB: |
8f118dcd JH |
72 | You must rebuild the module, |
73 | as the data will be compiled on building. | |
74 | ||
39f4556f | 75 | In the case of pure perl: |
8f118dcd JH |
76 | Rebuilding is not necessary, |
77 | as the data will be read on requirement. | |
2a204b45 | 78 | |
2b8d773d RGS |
79 | (2) Normalize.pmN (a pure perl module) may work without any other file |
80 | in this distribution. It must be renamed Normalize.pm, though. | |
82e740b6 | 81 | |
39f4556f | 82 | COPYRIGHT AND LICENSE |
45394607 | 83 | |
39f4556f | 84 | SADAHIRO Tomoyuki <SADAHIRO@cpan.org> |
45394607 | 85 | |
2b8d773d | 86 | Copyright(C) 2001-2007, SADAHIRO Tomoyuki. Japan. All rights reserved. |
45394607 | 87 | |
39f4556f RGS |
88 | This module is free software; you can redistribute it and/or |
89 | modify it under the same terms as Perl itself. |