Commit | Line | Data |
21aeefd5 |
1 | README for I18N::LangTags |
77b20956 |
2 | Time-stamp: "2004-10-06 23:19:39 ADT" |
21aeefd5 |
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 |
537c2f98 |
64 | <http://www.perl.com/CPAN/> to find a CPAN site near you. |
21aeefd5 |
65 | |
66 | |
67 | COPYRIGHT |
68 | |
77b20956 |
69 | Copyright 1998+, Sean M. Burke <sburke@cpan.org>, all rights |
21aeefd5 |
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. |