1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
=pod
=head1 NAME
Locale::Codes::LangFam - standard codes for language extension identification
=head1 SYNOPSIS
use Locale::Codes::LangFam;
$lext = code2langfam('apa'); # $lext gets 'Apache languages'
$code = langfam2code('Apache languages'); # $code gets 'apa'
@codes = all_langfam_codes();
@names = all_langfam_names();
=head1 DESCRIPTION
The C<Locale::Codes::LangFam> module provides access to standard codes
used for identifying language families, such as those as defined in
ISO 639-5.
Most of the routines take an optional additional argument which
specifies the code set to use. If not specified, the default ISO 639-5
language family codes will be used.
=head1 SUPPORTED CODE SETS
There are several different code sets you can use for identifying
language families. A code set may be specified using either a name, or a
constant that is automatically exported by this module.
For example, the two are equivalent:
$lext = code2langfam('apa','alpha');
$lext = code2langfam('apa',LOCALE_LANGFAM_ALPHA);
The codesets currently supported are:
=over 4
=item B<alpha>
This is the set of three-letter (lowercase) codes from ISO 639-5
such as 'apa' for Apache languages.
This is the default code set.
=back
=head1 ROUTINES
=over 4
=item B<code2langfam ( CODE [,CODESET] )>
=item B<langfam2code ( NAME [,CODESET] )>
=item B<langfam_code2code ( CODE ,CODESET ,CODESET2 )>
=item B<all_langfam_codes ( [CODESET] )>
=item B<all_langfam_names ( [CODESET] )>
=item B<Locale::Codes::LangFam::rename_langfam ( CODE ,NEW_NAME [,CODESET] )>
=item B<Locale::Codes::LangFam::add_langfam ( CODE ,NAME [,CODESET] )>
=item B<Locale::Codes::LangFam::delete_langfam ( CODE [,CODESET] )>
=item B<Locale::Codes::LangFam::add_langfam_alias ( NAME ,NEW_NAME )>
=item B<Locale::Codes::LangFam::delete_langfam_alias ( NAME )>
=item B<Locale::Codes::LangFam::rename_langfam_code ( CODE ,NEW_CODE [,CODESET] )>
=item B<Locale::Codes::LangFam::add_langfam_code_alias ( CODE ,NEW_CODE [,CODESET] )>
=item B<Locale::Codes::LangFam::delete_langfam_code_alias ( CODE [,CODESET] )>
These routines are all documented in the Locale::Codes::API man page.
=back
=head1 SEE ALSO
=over 4
=item B<Locale::Codes>
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-5/id.php>
ISO 639-5 .
=back
=head1 AUTHOR
See Locale::Codes for full author history.
Currently maintained by Sullivan Beck (sbeck@cpan.org).
=head1 COPYRIGHT
Copyright (c) 2011-2012 Sullivan Beck
This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
=cut
|