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