summaryrefslogtreecommitdiff
path: root/Master/tlpkg/tlperl/lib/Locale/Language.pod
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/tlperl/lib/Locale/Language.pod')
-rw-r--r--Master/tlpkg/tlperl/lib/Locale/Language.pod50
1 files changed, 33 insertions, 17 deletions
diff --git a/Master/tlpkg/tlperl/lib/Locale/Language.pod b/Master/tlpkg/tlperl/lib/Locale/Language.pod
index df9c1472fbd..c6a25032735 100644
--- a/Master/tlpkg/tlperl/lib/Locale/Language.pod
+++ b/Master/tlpkg/tlperl/lib/Locale/Language.pod
@@ -26,33 +26,37 @@ specifies the code set to use. If not specified, the default ISO
=head1 SUPPORTED CODE SETS
There are several different code sets you can use for identifying
-languages. The ones currently supported are:
+languages. A code set may be specified using either a name, or a
+constant that is automatically exported by this module.
-=over 4
+For example, the two are equivalent:
+
+ $lang = code2language('en','alpha-2');
+ $lang = code2language('en',LOCALE_CODE_ALPHA_2);
+
+The codesets currently supported are:
-=item B<alpha-2>
+=over 4
-This is the set of two-letter (lowercase) codes from ISO 639, such
-as 'he' for Hebrew.
+=item B<alpha-2, LOCALE_LANG_ALPHA_2>
-This code set is identified with the symbol C<LOCALE_LANG_ALPHA_2>.
+This is the set of two-letter (lowercase) codes from ISO 639-1, such
+as 'he' for Hebrew. It also includes additions to this set included
+in the IANA language registry.
This is the default code set.
-=item B<alpha-3>
+=item B<alpha-3, LOCALE_LANG_ALPHA_3>
This is the set of three-letter (lowercase) bibliographic codes from
-ISO 639, such as 'heb' for Hebrew.
-
-This code set is identified with the symbol C<LOCALE_LANG_ALPHA_3>.
+ISO 639-2 and 639-5, such as 'heb' for Hebrew. It also includes
+additions to this set included in the IANA language registry.
-=item B<term>
+=item B<term, LOCALE_LANG_TERM>
This is the set of three-letter (lowercase) terminologic codes from
ISO 639.
-This code set is identified with the symbol C<LOCALE_LANG_TERM>.
-
=back
=head1 ROUTINES
@@ -85,7 +89,7 @@ This code set is identified with the symbol C<LOCALE_LANG_TERM>.
=item B<Locale::Language::delete_language_code_alias ( CODE [,CODESET] )>
-These routines are all documented in the Locale::Codes man page.
+These routines are all documented in the Locale::Codes::API man page.
=back
@@ -95,11 +99,23 @@ These routines are all documented in the Locale::Codes man page.
=item B<Locale::Codes>
-=item B<Locale::Constants>
+The Locale-Codes distribution.
+
+=item B<Locale::Codes::API>
+
+The list of functions supported by this module.
=item B<http://www.loc.gov/standards/iso639-2/>
-Source of the ISO 639 codes.
+Source of the ISO 639-2 codes.
+
+=item B<http://www.loc.gov/standards/iso639-5/>
+
+Source of the ISO 639-5 codes.
+
+=item B<http://www.iana.org/assignments/language-subtag-registry>
+
+The IANA language subtag registry.
=back
@@ -113,7 +129,7 @@ Currently maintained by Sullivan Beck (sbeck@cpan.org).
Copyright (c) 1997-2001 Canon Research Centre Europe (CRE).
Copyright (c) 2001-2010 Neil Bowers
- Copyright (c) 2010-2011 Sullivan Beck
+ Copyright (c) 2010-2012 Sullivan Beck
This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.