diff options
Diffstat (limited to 'Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod')
-rw-r--r-- | Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod | 72 |
1 files changed, 24 insertions, 48 deletions
diff --git a/Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod b/Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod index e1d86466fac..f827732ca7d 100644 --- a/Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod +++ b/Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod @@ -15,12 +15,11 @@ Locale::Codes::Country - standard codes for country identification @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 +This module provides access to several code sets that can be used for identifying countries, such as those defined in ISO 3166-1. @@ -80,56 +79,33 @@ Locale::Codes::Changes document for details. =over 4 -=item B<code2country ( CODE [,CODESET] [,'retired'])> +=item B<code2country(CODE [,CODESET] [,'retired'])> -=item B<country2code ( NAME [,CODESET] [,'retired'])> +=item B<country2code(NAME [,CODESET] [,'retired'])> -=item B<country_code2code ( CODE ,CODESET ,CODESET2 )> +=item B<country_code2code(CODE ,CODESET ,CODESET2)> -=item B<all_country_codes ( [CODESET] [,'retired'])> +=item B<all_country_codes([CODESET] [,'retired'])> -=item B<all_country_names ( [CODESET] [,'retired'])> +=item B<all_country_names([CODESET] [,'retired'])> -=item B<Locale::Codes::Country::rename_country ( CODE ,NEW_NAME [,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::add_country(CODE ,NAME [,CODESET])> -=item B<Locale::Codes::Country::delete_country ( CODE [,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::add_country_alias(NAME ,NEW_NAME)> -=item B<Locale::Codes::Country::delete_country_alias ( 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::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::add_country_code_alias(CODE ,NEW_CODE [,CODESET])> -=item B<Locale::Codes::Country::delete_country_code_alias ( 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 in the December -2014 release. - -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. +These routines are all documented in the L<Locale::Codes::API> man page. =back @@ -137,35 +113,35 @@ all 2.X releases, but has been dropped as of 3.00. =over 4 -=item B<Locale::Codes> +=item L<Locale::Codes> The Locale-Codes distribution. -=item B<Locale::Codes::API> +=item L<Locale::Codes::API> The list of functions supported by this module. -=item B<Locale::SubCountry> +=item L<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/home/standards/country_codes.htm> +=item L<http://www.iso.org/iso/home/standards/country_codes.htm> Official home page for the ISO 3166 maintenance agency. -=item B<http://www.iso.org/iso/home/standards/country_codes/iso-3166-1_decoding_table.htm> +=item L<http://www.iso.org/iso/home/standards/country_codes/iso-3166-1_decoding_table.htm> The source of ISO 3166-1 two-letter codes used by this module. -=item B<http://www.iana.org/domains/root/db/> +=item L<http://www.iana.org/domains/root/db/> Official source of the top-level domain names. -=item B<http://unstats.un.org/unsd/methods/m49/m49alpha.htm> +=item L<http://unstats.un.org/unsd/methods/m49/m49alpha.htm> The source of the official ISO 3166-1 three-letter codes and three-digit codes. @@ -174,13 +150,13 @@ For some reason, this table is incomplete! Several countries are missing from it, and I cannot find them anywhere on the UN site. I no longer use this as a source of data. -=item B<https://www.cia.gov/library/publications/the-world-factbook/appendix/print_appendix-d.html> +=item L<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> +=item L<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 |