summaryrefslogtreecommitdiff
path: root/Master/tlpkg/tlperl/lib/Locale/Codes/LangFam.pod
blob: 7faabee5b104382dcbf8b07ab04aa94b3dcc1e63 (plain)
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