summaryrefslogtreecommitdiff
path: root/ext/Unicode/Normalize/README
blob: f1b1754dd4e40b819f5bf1e24940473f35b8a142 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
Unicode/Normalize version 0.20
===================================

Unicode::Normalize - Unicode Normalization Forms

SYNOPSIS

  use Unicode::Normalize;

  $NFD_string  = NFD($string);  # Normalization Form D
  $NFC_string  = NFC($string);  # Normalization Form C
  $NFKD_string = NFKD($string); # Normalization Form KD
  $NFKC_string = NFKC($string); # Normalization Form KC

  or

  use Unicode::Normalize 'normalize';

  $NFD_string  = normalize('D',  $string);  # Normalization Form D
  $NFC_string  = normalize('C',  $string);  # Normalization Form C
  $NFKD_string = normalize('KD', $string);  # Normalization Form KD
  $NFKC_string = normalize('KC', $string);  # Normalization Form KC


INSTALLATION

Perl 5.6 or later

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

If you have a C compiler and want to use the XS version,
type the following:

   perl Makefile.PL xs
   make
   make test
   make install

If you decide to install the NoXS version after trying to build the XS,
type the following:

   make clean
   perl Makefile.PL noxs
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

Carp
Exporter
File::Copy
File::Spec

unicore/CombiningClass.pl         (or unicode/CombiningClass.pl)
unicore/Decomposition.pl          (or unicode/Decomposition.pl)
unicore/CompositionExclusions.txt (or unicode/CompExcl.txt)

CAVEAT

(1) In the perl-current, unicore/CompExcl.txt
  is renamed unicore/CompositionExclusions.txt.

(2) After these unicore/*.* files are updated.

  In the case of an XS version:
    You must rebuild the module,
    as the data will be compiled on building.

  In the case of a NoXS version:
    Rebuilding is not necessary,
    as the data will be read on requirement.

COPYRIGHT AND LICENCE

  SADAHIRO Tomoyuki

  SADAHIRO@cpan.org

  http://homepage1.nifty.com/nomenclator/perl/

  Copyright(C) 2001-2003, SADAHIRO Tomoyuki. Japan. All rights reserved.

  This module is free software; you can redistribute it
  and/or modify it under the same terms as Perl itself.