summaryrefslogtreecommitdiff
path: root/Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod')
-rw-r--r--Master/tlpkg/tlperl/lib/Locale/Codes/Country.pod72
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