Move Filter::Simple from ext/ to dist/
[perl.git] / ext / I18N-LangTags / README
1 README for I18N::LangTags
2                                         Time-stamp: "2004-10-06 23:19:39 ADT"
3
4                             I18N::LangTags
5
6 I18N::LangTags - functions for dealing with RFC3066-style language
7 tags
8
9 Language tags are a formalism, described in RFC 3066 (obsoleting
10 1766), for declaring what language form (language and possibly
11 dialect) a given chunk of information is in.
12
13 This library provides functions for common tasks involving language
14 tags (notably the extraction of them, comparing them, and testing the
15 formal validity of them) as is needed in a variety of protocols and
16 applications.
17
18
19 I18N::LangTags::List -- tags and names for human languages.  This
20 module goes from known language tag names ("fr-CA") to their English
21 names ("Canadian French").  Its documentation also lists the several
22 hundred known tags and some common subforms.  You may find this useful
23 as a reference.
24
25
26 See the POD for more information.
27
28
29 INSTALLATION
30
31 You install I18N::LangTags and I18N::LangTags::List, as you would
32 install any perl module library, by running these commands:
33
34    perl Makefile.PL
35    make
36    make test
37    make install
38
39 If you want to install a private copy of I18N::LangTags in your home
40 directory, then you should try to produce the initial Makefile with
41 something like this command:
42
43   perl Makefile.PL LIB=~/perl
44
45 See perldoc perlmodinstall for more information on installing modules.
46
47
48 DOCUMENTATION
49
50 POD-format documentation is included in LangTags.pm.  POD is readable
51 with the 'perldoc' utility.  See ChangeLog for recent changes.
52
53
54 SUPPORT
55
56 Questions, bug reports, useful code bits, and suggestions for
57 I18N::LangTags should just be sent to me at sburke@cpan.org
58
59
60 AVAILABILITY
61
62 The latest version of I18N::LangTags is available from the
63 Comprehensive Perl Archive Network (CPAN).  Visit
64 <http://www.perl.com/CPAN/> to find a CPAN site near you.
65
66
67 COPYRIGHT
68
69 Copyright 1998+, Sean M. Burke <sburke@cpan.org>, all rights
70 reserved.
71
72 The programs and documentation in this dist are distributed in
73 the hope that they will be useful, but without any warranty; without
74 even the implied warranty of merchantability or fitness for a
75 particular purpose.
76
77 This library is free software; you can redistribute it and/or modify
78 it under the same terms as Perl itself.