| 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. |