Commit | Line | Data |
---|---|---|
86530b38 AT |
1 | README for I18N::LangTags |
2 | Time-stamp: "2001-05-29 21:52:15 MDT" | |
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.cpan.org/> to find a CPAN site near you. | |
65 | ||
66 | ||
67 | COPYRIGHT | |
68 | ||
69 | Copyright 1998-2001, 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. |