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