diff options
Diffstat (limited to 'Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod')
-rw-r--r-- | Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod | 214 |
1 files changed, 0 insertions, 214 deletions
diff --git a/Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod b/Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod deleted file mode 100644 index c559c37bf4e..00000000000 --- a/Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod +++ /dev/null @@ -1,214 +0,0 @@ -=pod - -=head1 NAME - -Locale::Codes::Country - standard codes for country identification - -=head1 SYNOPSIS - - use Locale::Codes::Country; - - $country = code2country('jp' [,CODESET]); # $country gets 'Japan' - $code = country2code('Norway' [,CODESET]); # $code gets 'no' - - @codes = all_country_codes( [CODESET]); - @names = all_country_names(); - - # semi-private routines - Locale::Codes::Country::alias_code('uk' => 'gb'); - Locale::Codes::Country::rename_country('gb' => 'Great Britain'); - -=head1 DESCRIPTION - -The C<Locale::Codes::Country> module provides access to several code sets -that can be used for identifying countries, such as those defined in -ISO 3166-1. - -Most of the routines take an optional additional argument which -specifies the code set to use. If not specified, the default ISO -3166-1 two-letter codes will be used. - -=head1 SUPPORTED CODE SETS - -There are several different code sets you can use for identifying -countries. 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: - - $country = code2country('jp','alpha-2'); - $country = code2country('jp',LOCALE_CODE_ALPHA_2); - -The codesets currently supported are: - -=over 4 - -=item B<alpha-2, LOCALE_CODE_ALPHA_2> - -This is the set of two-letter (lowercase) codes from ISO 3166-1, such -as 'tv' for Tuvalu. - -This is the default code set. - -=item B<alpha-3, LOCALE_CODE_ALPHA_3> - -This is the set of three-letter (lowercase) codes from ISO 3166-1, -such as 'brb' for Barbados. These codes are actually defined and -maintained by the U.N. Statistics division. - -=item B<numeric, LOCALE_CODE_NUMERIC> - -This is the set of three-digit numeric codes from ISO 3166-1, such as -064 for Bhutan. These codes are actually defined and maintained by the -U.N. Statistics division. - -If a 2-digit code is entered, it is converted to 3 digits by prepending -a 0. - -=item B<fips-10, LOCALE_CODE_FIPS> - -The FIPS 10 data are two-letter (uppercase) codes assigned by the -National Geospatial-Intelligence Agency. - -=item B<dom, LOCALE_CODE_DOM> - -The IANA is responsible for assigning two-letter (uppercase) top-level -domain names to each country. - -=back - -=head1 ROUTINES - -=over 4 - -=item B<code2country ( CODE [,CODESET] )> - -=item B<country2code ( NAME [,CODESET] )> - -=item B<country_code2code ( CODE ,CODESET ,CODESET2 )> - -=item B<all_country_codes ( [CODESET] )> - -=item B<all_country_names ( [CODESET] )> - -=item B<Locale::Codes::Country::rename_country ( CODE ,NEW_NAME [,CODESET] )> - -=item B<Locale::Codes::Country::add_country ( CODE ,NAME [,CODESET] )> - -=item B<Locale::Codes::Country::delete_country ( CODE [,CODESET] )> - -=item B<Locale::Codes::Country::add_country_alias ( NAME ,NEW_NAME )> - -=item B<Locale::Codes::Country::delete_country_alias ( NAME )> - -=item B<Locale::Codes::Country::rename_country_code ( CODE ,NEW_CODE [,CODESET] )> - -=item B<Locale::Codes::Country::add_country_code_alias ( CODE ,NEW_CODE [,CODESET] )> - -=item B<Locale::Codes::Country::delete_country_code_alias ( CODE [,CODESET] )> - -These routines are all documented in the Locale::Codes::API man page. - -=item B<alias_code ( ALIAS, CODE [,CODESET] )> - -Version 2.07 included 2 functions for modifying the internal data: -rename_country and alias_code. Both of these could be used only to -modify the internal data for country codes. - -As of 3.10, the internal data for all types of codes can be modified. - -The alias_code function is preserved for backwards compatibility, but -the following two are identical: - - alias_code(ALIAS,CODE [,CODESET]); - rename_country_code(CODE,ALIAS [,CODESET]); - -and the latter should be used for consistency. - -The alias_code function is deprecated and will be removed at some point -in the future. - -B<Note:> this function was previously called _alias_code, but the -leading underscore has been dropped. The old name was supported for -all 2.X releases, but has been dropped as of 3.00. - -=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<Locale::SubCountry> - -ISO codes for country sub-divisions (states, counties, provinces, -etc), as defined in ISO 3166-2. This module is not part of the -Locale-Codes distribution, but is available from CPAN in -CPAN/modules/by-module/Locale/ - -=item B<http://www.iso.org/iso/country_codes> - -Official home page for the ISO 3166 maintenance agency. - -Unfortunately, they do not make the actual ISO available for free, -so I cannot check the alpha-3 and numerical codes here. - -=item B<http://www.iso.org/iso/list-en1-semic-3.txt> - -The source of ISO 3166-1 two-letter codes used by this -module. - -=item B<http://unstats.un.org/unsd/methods/m49/m49alpha.htm> - -The source of the official ISO 3166-1 three-letter codes and -three-digit codes. - -For some reason, this table is incomplete! Several countries are -missing from it, and I cannot find them anywhere on the UN site. I -get as much of the data from here as I can. - -=item B<http://earth-info.nga.mil/gns/html/digraphs.htm> - -The official list of the FIPS 10 codes. - -=item B<http://www.iana.org/domains/> - -Official source of the top-level domain names. - -=item B<https://www.cia.gov/library/publications/the-world-factbook/appendix/print_appendix-d.html> - -The World Factbook maintained by the CIA is a potential source of -the data. Unfortunately, it adds/preserves non-standard codes, so it is no -longer used as a source of data. - -=item B<http://www.statoids.com/wab.html> - -Another unofficial source of data. Currently, it is not used to get -data, but the notes and explanatory material were very useful for -understanding discrepancies between the sources. - -=back - -=head1 AUTHOR - -See Locale::Codes for full author history. - -Currently maintained by Sullivan Beck (sbeck@cpan.org). - -=head1 COPYRIGHT - - Copyright (c) 1997-2001 Canon Research Centre Europe (CRE). - Copyright (c) 2001-2010 Neil Bowers - 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. - -=cut |