Commit | Line | Data |
51683ce6 |
1 | Unicode/Normalize version 1.03 |
45394607 |
2 | =================================== |
3 | |
f027f502 |
4 | Unicode::Normalize - Unicode Normalization Forms |
45394607 |
5 | |
6 | SYNOPSIS |
7 | |
39f4556f |
8 | (1) using function names exported by default: |
9 | |
45394607 |
10 | use Unicode::Normalize; |
11 | |
8f118dcd |
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 |
19 | use Unicode::Normalize 'normalize'; |
20 | |
8f118dcd |
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 |
26 | INSTALLATION |
27 | |
39f4556f |
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 |
32 | |
33 | perl Makefile.PL |
34 | make |
35 | make test |
36 | make install |
37 | |
82e740b6 |
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 |
41 | perl disableXS |
42 | perl Makefile.PL |
ac5ea531 |
43 | make |
44 | make test |
45 | make install |
46 | |
82e740b6 |
47 | After building no-XSUB, if you decide to install XSUB, |
48 | type the following (!! "enableXS" must run before "Makefile.PL" !!): |
ab8fe378 |
49 | |
50 | make clean |
82e740b6 |
51 | perl enableXS |
52 | perl Makefile.PL |
ab8fe378 |
53 | make |
54 | make test |
55 | make install |
56 | |
45394607 |
57 | DEPENDENCIES |
58 | |
39f4556f |
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 |
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 |
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 |
76 | Rebuilding is not necessary, |
77 | as the data will be read on requirement. |
2a204b45 |
78 | |
2b8d773d |
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 |
88 | This module is free software; you can redistribute it and/or |
89 | modify it under the same terms as Perl itself. |