1Locale::Codes::Changes(U3s)er Contributed Perl DocumentatLioocnale::Codes::Changes(3)
2
6 Locale::Codes::Changes - details changes to Locale::Codes
7
9 This describes the changes made to modules in the Locale-Codes
10 distribution. Major changes are marked with asterisks (*). For the
11 most part, all modules have remained backward compatible at every
12 release, but occasionally a change is made which is backward
13 incompatible. These are marked with an exclamation mark (!).
14 As of 3.00, the codes are autogenerated from the standards. With each
16 release, codes will be re-generated and tested to see if any code
17 changed. Any time there are any changes to the codes, it will be
18 flagged below with a change: NEW CODE(s).
19 I intend to check for new codes four times a year (March, June,
21 September, December). I will also try to respond to requests for a
22 release due to changes made to the standards, so if a code changes that
23 you use, feel free to contact me. Based on my available time and the
24 time until the next release is scheduled, I will try to do a release
25 any time the standards change.
26
28 NEW CODE(s)
29
31 NEW CODE(s)
32
34 NEW CODE(s)
35
37 NEW CODE(s)
38 NOTE: no code changes on 2021-06-01 so no release made at that
39 time.
40 Added code2names
42 Also code2countrys, code2languages, etc. This allows you to see
43 all names and aliases that correspond to a code. My apologies for
44 making 'countrys' to be the plural of 'country', but because these
45 modules are all generated from a template, I didn't want to put in
46 an exception for the strange pluralization.
47 Prompted by David Cantrell.
49
51 NEW CODE(s)
52
54 NEW CODE(s)
55
57 NEW CODE(s)
58
60 NEW CODE(s)
61 Fixed bug deleting retired codes
62 The delete_code function failed if you tried to delete a retired
63 code. This is now fixed. GitHub #12
64
66 NEW CODE(s)
67 NOTE: no code changes on 2019-12-01 so no release made at that
68 time.
69 Fixed a retired code
71
73 NEW CODE(s)
74 Fixed tests
75 Tests were not working correctly since the previous version. This
76 is now fixed.
77 Fixed error messages
79 Many of the error messages were inconsistent or completely wrong
80 (due to cut-and-paste errors). They have been fixed.
81 Fixed some return codes
83 The name2code and code2name functions returned 1 in the case of an
84 error in some situations instead of undef (which was the documented
85 value).
86 Removed unnecessary dependencies
88 A number of modules were included as test dependencies that are
89 only used by the author when preparing releases. These have been
90 removed as dependencies. Petr Pisar on GitHub #11
91
93 NEW CODE(s)
94 Converted tests to use Test::Inter
95 Now uses the same module to do tests as all my other modules.
96
98 NEW CODE(s)
99
101 NEW CODE(s)
102 Removed travis file from the tarball
103 The tarball had a .travis.yml file in it that wasn't in the
104 MANIFEST file. Since the MANIFEST file is automatically generated
105 by the perl mkmanifest tool, since it didn't see the .travis.yml
106 file, I have excluded it from the tarball. Reported by Mohammad S
107 Anwar on GitHub (#10)
108
110 NEW CODE(s)
111 (*) Locale-Codes removed from core
112 Locale-Codes will no longer be distributed in new versions of perl.
113 Documentation fix
115 Fixed an incorrect link reported by Mohammad S Anwar on GitHub (#9)
116
118 NEW CODE(s)
119
121 NEW CODE(s)
122
124 NEW CODE(s)
125 (*) Deprecated in core
126 Because correct usage of any of the Locale::Codes modules requires
127 that they be kept up-to-date, I have long felt that it should not
128 be distributed as a core module. After discussion on the
129 perl5-porters list, it is agreed, and the deprecation process has
130 been started. Starting with perl 5.28.0, Locale-Codes will be
131 flagged as deprecated, and it will be removed in version 5.30.0 .
132 Thanks to p5p-porters (especially Dagfinn Ilmari Mannsaker) for
134 discussion and guidance.
135 Changes from a github pull request applied
137 A couple minor changes (updated .travis.yml to include newest
138 versions of perl; and a couple changes to pod_coverage.t) reported
139 by lancew on GitHub.
140 Got rid of Build.PL
142 Simplified things by only supporting one of Makefile.PL/Build.PL
143 (and the latter has been removed from perl core some time ago). RT
144 123572
145 Fixed INSTALLDIRS
147 The behavior of installing core modules changed in 5.12 a bit, and
148 Makefile.PL now reflects that. RT 123571
149
151 NEW CODE(s)
152
154 NEW CODE(s)
155 Fixed the default error condition in legacy modules.
156 With the addition of the OO module, better error handling was added
157 (and it was on by default). The non-OO (legacy) modules did not
158 report errors, so code that uses them, would now behave differently
159 if invalid data were passed in.
160 I have turned off error handling by default in the legacy modules.
162 The show_errors method was added to each of the non-OO modules to
163 report errors if desired.
164 Reported by dmaestro on GitHub.
166
168 NEW CODE(s)
169
171 NEW CODE(s)
172 Tests no longer require (.) in INC
173 As of perl 5.25.11, (.) is being removed from INC. I had to adjust
174 the tests accordingly.
175
177 NEW CODE(s)
178 (*) Rewrote as OO module
179 The core module (Locale::Codes) is now an OO module that can be
180 used directly. All of the other modules (Locale::Codes::TYPE) are
181 still the older functional interfaces and remain unchanged.
182 Added some constants
184 Historically, the constant names used to identify the codesets have
185 been named inconsistently. The original constants for codesets
186 are:
187 Type Constants
189 country LOCALE_CODE_*
191 currency LOCALE_CURR_*
192 language LOCALE_LANG_*
193 script LOCALE_SCRIPT_*
195 langfam LOCALE_LANGFAM_*
196 langvar LOCALE_LANGVAR_*
197 langext LOCALE_LANGEXT_*
198 For consistencies sake, I have added some new codes (which are
200 otherwise identical to the irregularly named codes):
201 country LOCALE_COUNTRY_*
203 currency LOCALE_CURRENCY_*
204 language LOCALE_LANGUAGE_*
205 Going forward, all constants will include the full name of the code
207 type.
208 Non-OO modules are now generated
210 All non-OO modules are now automatically generated. This will make
211 it easier to keep them 100% consistent as well as making it easier
212 to add new types of code sets.
213 All of the documentation for them is also generated except for the
215 description of the code sets. That has been moved into the
216 Locale::Codes::Types document.
217 Fixed a bug where constants were not exported
219 Some of the constants for some of the newer code sets were not
220 exported properly. This was fixed when I started generating the
221 non-OO modules, but was reported (after I had already fixed it in
222 development) as RT 119741 .
223
225 Added Czech republic aliases back in
226 Common Czech republic aliases disappeared from the standards, so I
227 added them back in. Rob Emery
228
230 NEW CODE(s)
231 Jiri Bohac noted that they were needed so this was release a couple
232 weeks earlier than planned.
233
235 NEW CODE(s)
236
238 Added UN codes back in
239 The UN codes have been added back in as their own list of codes.
240 Jarkko Hietaniemi
241 Added GENC codes
243 The GENC codes have been added. These are the new US Government
244 codes that replace the FIPS-10 codes. They are based on, but not
245 identical to the ISO 3166 codes.
246
248 NEW CODE(s)
249 Tests reworked
250 Improved test suite (and made some changes to Codes.pm) based on
251 Devel::Cover. Test suite now has 100% coverage.
252
254 NEW CODE(s)
255
257 NEW CODE(s)
258 (!) Removed alias_code function
259 The alias_code function was preserved for backward compatibility,
260 but has been deprecated since 3.20. It has been removed.
261
263 NEW CODE(s)
264 Documentation improvements
265 Many changes to the formatting in the documentation to improve it.
266 Suggested by Pete Houston.
267
269 NEW CODE(s)
270
272 NEW CODE(s)
273 Filled out LOCALE_LANG_TERM codeset
274 The terminologic language codes only included codes from languages
275 where the ISO specified both a bibliographic code and a
276 terminologic code. If both are not specified, the better solution
277 was to use the code for both code sets. Prompted by a suggestion
278 by Jarkko Hietaniemi.
279 Moved repository to GitHub
281 Suggested by Gabor Szabo.
282
284 NEW CODE(s)
285
287 NEW CODE(s)
288 Bug fixes
289 Fixed a bug in the scripts used to extract data from spreadsheets
290 that prevented the SHP currency code from being found. RT 94229
291
293 NEW CODE(s)
294 alias_code remove date set
295 The alias_code function exists for backward compatibility. It has
296 been deprecated since version 3.20 when it was replaced by
297 rename_country_code. The alias_code function will be removed in
298 the December 2014 release.
299 Bug fixes
301 Fixed a problem that was preventing rename_* functions to not work.
302 RT 92680.
303
305 NEW CODE(s)
306 ISO 3166 country codes improved
307 ISO 3166 is now browsable online (previously, only the alpha-2
308 codes were) and it contains more accurate information than the
309 previous sources, so I've switched to using the full standard. In
310 response to RT 92303 which reported some codes being 'retired' that
311 should not have been.
312 Bug fixes
314 Fixed the pod test files so that pod tests won't get run at install
315 time. In response to RT 91167.
316
318 NEW CODE(s)
319
321 NEW CODE(s)
322 * FIPS-10 country codes removed
323 As of June, the FIPS codes are not being published in their
324 entirety. Only changes to the codes are published. This adds a
325 huge layer of complexity to maintaining the set, which is not worth
326 doing considering that the set is deprecated. As such, the code
327 set is no longer supported.
328
330 Documentation fixes
331 Some of the examples were not correct. RT 84589
332 Some typos corrected. RT 85692
334
336 NEW CODE(s)
337
339 NEW CODE(s)
340 Syria alias
341 Syria added as an alias. RT 82747
342 FIPS-10 country codes deprecated
344 The FIPS-10 document is being withdrawn. It was deprecated in
345 2008, and is being updated now only until all the agencies that use
346 it have switched to something else. The current version no longer
347 lists the long names for countries. These long names (such as
348 'Republic of Albania' for Albania) only appeared in the old FIPS-10
349 document which is no longer available, so they are no longer
350 available in this module.
351 I will continue to support the FIPS-10 codeset as long as it is
353 available, but at that point, it will be withdrawn immediately. If
354 an official end-of-life date is announced, I will include a notice
355 here. Otherwise, support for the codeset will be discontinued when
356 the document is withdrawn.
357 You are encouraged to no longer use the FIPS-10 codeset.
359 Domain country codes now come from ISO 3166
361 The IANA domain codes have changed slightly. The IANA no longer
362 publishes a list of countries associated with their codes.
363 Instead, they use the ISO 3166 codes and country names. However,
364 they support a few non-standard codes, so I will continue to
365 maintain this codeset. The domain codes are now lowercase to
366 correspond to the ISO 3166 codes.
367
369 NEW CODE(s)
370
372 NEW CODE(s)
373 Updated perl version required
374 Changed 'require 5.002' (which dated back to the version 2.xx
375 Locale-Codes) to 'require 5.006'. Some features used in Locale-
376 Codes are not supported that far back. Nicholas Clark
377 Sorted deprecated codes
379 The codes in the generated deprecated codes modules were not sorted
380 making version diffs bigger than they should be. Nicholas Clark
381
383 NEW CODE(s)
384
386 NEW CODE(s)
387 Added limited support for deprecated codes
388 The code2XXX, XXX2code, all_XXX_codes, and all_XXX_names functions
389 now support retired codes. RT 71124
390 Fixed capitalization
392 The 'South Sudan' country was all caps. RT 71024
393 Pod tests off by default
395 The pod tests will not run at install time. RT 71122
396 Codesets may be specified by name
398 All codesets may be specified by a constant or by their name now.
399 Previously, they were specified only by a constant.
400 alias_code deprecated
402 The alias_code function exists for backward compatibility. It has
403 been replaced by rename_country_code . The alias_code function
404 will be removed sometime after September, 2013 .
405 Code cleanup
407 All work is now done in the central module (Locale::Codes).
408 Previously, some was still done in the wrapper modules
409 (Locale::Codes::*) but that is gone now.
410 Added LangFam module
412 Added Language Family codes (langfam) as defined in ISO 639-5.
413
415 NEW CODE(s)
416 No longer use CIA data
417 The CIA world added non-standard values, so I no longer use it as a
418 source of data. Based on a report by Michiel Beijen.
419
421 NEW CODE(s)
422 Added new types of codes
423 Added Language Extension codes (langext) and Language Variation
424 codes (langvar) as defined in the IANA language registry.
425 Added new codeset(s)
427 Added language codes from ISO 639-5
428 Added language/script codes from the IANA language subtag registry
430 Bug fixes
432 Fixed an uninitialized value warning. RT 67438
433 Fixed the return value for the all_XXX_codes and all_XXX_names
435 functions. RT 69100
436 Reorganized code
438 Reorganized modules to move Locale::MODULE to Locale::Codes::MODULE
439 to allow for cleaner future additions. The original four modules
440 (Locale::Language, Locale::Currency, Locale::Country,
441 Locale::Script) will continue to work, but all new sets of codes
442 will be added in the Locale::Codes namespace.
443
445 NEW CODE(s)
446
448 NEW CODE(s)
449 Minor fixes
450 Added version number to Makefile.PL/Build.PL requirement for POD
451 testing modules. RT 62247
452 Changed 'use vars' to 'our'
454
456 NEW CODE(s)
457 Bug fixes
458 Stripped out some HTML that got included with some codes.
459
461 NEW CODE(s)
462
464 NEW CODE(s)
465 Reorganized code
466 Renamed test.pl to testfunc.pl to avoid causing an error when built
467 as part of perl.
468
470 NEW CODE(s)
471 Added new codeset(s)
472 Added the IANA domain names to Country
473 Bug fixes
475 Fixed a problem that produced warnings with perl 5.11.5. Jerry D.
476 Hedden
477
479 NEW CODE(s)
480 Reorganized code
481 Moved support files into the Locale::Codes namespace.
482 The work done in each of the Locale::XXX modules was virtually
484 identical to each other. It has all been moved to a central module
485 and the Locale::XXX modules are now just wrappers.
486 (!) Changed XXX_code2code behavior slightly
488 In previous versions, passing in the same code set for both code
489 set arguments would automatically return undef. For example:
490 country_code2code('bo',LOCALE_CODE_ALPHA_2,LOCALE_CODE_ALPHA_2);
492 => undef
493 This doesn't seem like reasonable behavior, so it has been changed
495 to allow the same code set:
496 country_code2code('bo',LOCALE_CODE_ALPHA_2,LOCALE_CODE_ALPHA_2);
498 => 'bo'
499 Note that if an invalid code is passed in, undef will still be
501 returned:
502 country_code2code('bol',LOCALE_CODE_ALPHA_2,LOCALE_CODE_ALPHA_2);
504 => undef
505 Added many semi-private routines
507 Previous versions had only two semi-private routines:
508 rename_country and alias_code which had the ability to modify the
509 internal data in a couple of very limited ways. It was requested
510 (in an anonymous posting by someone named Steve and also by Steve
511 Hay - unknown if they are the same person or two different Steves)
512 that better support for modifying internal data, so a full set of
513 routines were added.
514 The full set of routines includes:
516 rename_country
518 rename_language
519 rename_currency
520 rename_script
521 add_country
523 add_language
524 add_currency
525 add_script
526 delete_country
528 delete_language
529 delete_currency
530 delete_script
531 add_country_alias
533 add_language_alias
534 add_currency_alias
535 add_script_alias
536 delete_country_alias
538 delete_language_alias
539 delete_currency_alias
540 delete_script_alias
541 rename_country_code
543 rename_language_code
544 rename_currency_code
545 rename_script_code
546 add_country_code_alias
548 add_language_code_alias
549 add_currency_code_alias
550 add_script_code_alias
551 delete_country_code_alias
553 delete_language_code_alias
554 delete_currency_code_alias
555 delete_script_code_alias
556 New aliases
558 Added "UK" alias. Steve Hay
559
561 Fixed Makefile.PL and Build.PL
562 They now install as core modules as they are supposed to. Reported
563 in RT 54526
564
566 NEW CODE(s)
567 (*) New maintainer
568 From 1997 to 2004, Locale::Codes was maintained by Neil Bowers.
569 Unfortunately, no updates were made from June 2004 to January 2010.
570 During that time, a number of changes were made to the standards,
571 so the data included was out-of-date.
572 I contacted Neil to get his permission to assume maintenance of the
574 module, and he kindly agreed.
575 (*) (!) All codes are generated from standards
577 All of the values returned by the various functions are now values
578 directly from the standards. This means that the values returned in
579 the 2.xx series are not necessarily the same as the values returned
580 here.
581 As an example, the ISO 3166 standard which lists country codes
583 refers to the country associated with the code "bo" as "Bolivia,
584 Plurinational State of", so that is what is returned. In the 2.xx
585 series, "Bolivia" was returned. Also, the country names vary from
586 one standard to another. So the code "bol" which is maintained by
587 the United Nations returns the name of the country as "Bolivia
588 (Plurinational State of)". Some common aliases have been added, so
589 you can still request a code associated with a county name
590 "Bolivia".
591 Since the data comes from the standards, some "incorrect" values
593 are no longer supported. For example, 2.07 treated "Zaire" as an
594 alias for "Congo", but the country changed it's name, and "Zaire"
595 is not in the standard, so it has been dropped in 3.00.
596 Added new codeset(s)
598 FIPS 10 country codes (requested in RT 1755)
599 Alpha-3 and Term language codes (requested in RT 11730)
601 Numeric currency codes (requested in RT 18797)
603 (*) (!) Locale::Script changed
605 In 2.xx, Locale::Script assigned scripts to country codes, which is
606 NOT how it is done currently in the standards. It appears that an
607 older version of ISO 15924 did this, but I haven't found an old
608 version to confirm that, and in any case, that is not the case in
609 the current standards.
610 As a result, the Locale::Script module is completely incompatible
612 with the 2.xx version with respect to the types of codes it
613 supports. None of the old codes will work.
614 Added missing functions
616 I've added in some functions which were "missing" previously (since
617 there was only one set of codes supported, the code2code functions
618 didn't apply):
619 language_code2code
621 currency_code2code
622 so the interfaces for each type of codes are consistent.
624 (!) Dropped support for _alias_code
626 In Locale::Country, _alias_code was an allowed, but deprecated
627 function which was documented to be supported in the 2.xx series.
628 I've removed it.
629 (!) All functions return the standard value
631 code2country (and other equivalent functions) now returns the name
632 of the country specified in the standard (if the different
633 standards refer to the country by different variations in the name,
634 the results will differ based on the CODESET)
635 (!) rename_country function altered
637 The rename_country function from 2.07 would guess the CODESET
638 (unlike all other functions which used a default of
639 LOCALE_CODE_ALPHA_2). The guess can cause problems since (with the
640 addition of FIPS) codes may appear in different codesets for
641 different countries. The behavior has been changed to be the same
642 as other functions (default to LOCALE_CODE_ALPHA_2).
643
645 Made $_ local in the initialization code for each module change
646 back-propagated from Perl distribution
647 Removed two non ISO-8859-1 characters from language names change
649 back-propagated from Perl distribution
650 Added the following aliases, with a test case for each
652 - Burma added to Myanmar
653 - French Southern and Antarctic Lands to
654 French Southern Territories patch from TJ Mather
655 "Canadian Dollar" was misspelled as "Candian Dollar"
657 - noted by Nick Cabatoff, patch from Michael Hennecke
658 Changes to Locale::Country reflecting changes in ISO 3166
660 - added Aland Islands (ax, ala, 248)
661 - YUGOSLAVIA is now SERBIA AND MONTENEGRO
662 YU => CS
663 YUG => SCG
664 891 => 891 (unchanged)
665 (YUGOSLAVIA retained as an alias)
666 - EAST TIMOR changed to TIMOR-LESTE
667 (old name retained as an alias)
668 - three letter code for Romania changed from ROM to ROU
669 ZAIRE is now CONGO, THE DEMOCRATIC REPUBLIC OF THE
671 ZR => CD
672 ZAR => COD
673 180 => 180 (unchanged)
674 (ZAIRE retained as alias)
675
677 The four modules which have data after __DATA__ weren't closing the
678 DATA filehandle after reading from it, which they should. Bug and
679 patch from Steve Hay.
680
682 Added three letter codes for the countries that were missing them.
683 Patch from TJ Mather.
684 Documentation bug: one of the examples used => where the lvalue was
686 a constant, which isn't allowed, unless you put the () with the
687 constant to force the right interpretation. Pointed out by TJ
688 Mather and MYT.
689 Updated the URL for the appendix in the CIA world factbook. Patch
691 from TJ Mather.
692
694 Updated according to changes in ISO 3166-1 described in ISO 3166-1
695 newsletters V-4 and V-5, dated 2002-05-20:
696 - Kazakstan is now "Kazakhstan"
697 - Macau is now "Macao" The old names are retained as aliases.
698 The alpha-2 and alpha-3 codes for East Timor have changed:
700 tp -> tl
701 tmp -> tls the numeric code stays 626. If you want to support
702 the old codes, you can use the semi-private function alias_code().
703
705 Fixed a typo in the alias for the Vatican, reported (with patch) by
706 Philip Newton.
707 Added "Moldova" as an alias for "Moldova, Republic of"
709 Updated Makefile.PL to include AUTHOR and ABSTRACT
711
713 Added semi-private routine rename_country() to Locale::Country,
714 based on a patch from Iain Chalmers.
715 Added test rename.t for the above function.
717 Renamed _alias_code to be alias_code. Have retained the old name
719 for backwards compatibility. Will remove it when the major version
720 number next changes.
721
723 Split the documentation for all modules into separate pod files.
724 Made sure all =over were =over 4; some were other values.
726 The code2code() methods had one more shift than was needed.
728
730 Created Locale::Script which provides an interface to the ISO codes
731 for identification of scripts (writing scripts, rather than perl
732 style scripts). The codes are defined by ISO 15924, which is
733 currently in final draft. Thanks to Jarkko for pointing out this
734 new standard. All three code sets are supported, and a test-suite
735 added.
736 Added support for country name variants to Locale::Country, so that
738 country2code('USA')
739 country2code('United States')
740 country2code('United States of America') will all return 'us'.
741 This had been in the LIMITATIONS section since the first version.
742 Patch from TJ Mather with additional variants from me. Added test-
743 cases for these.
744 Added VERSION to Locale::Constants. Thanks to Jarkko for pointing
746 that it was missing.
747 Should really have bumped major version with previous release,
749 since there was a change to the API.
750
752 Added Locale::Constants, which defines three symbols for
753 identifying which codeset is being used:
754 LOCALE_CODE_ALPHA_2
756 LOCALE_CODE_ALPHA_3
757 LOCALE_CODE_NUMERIC
758 Updated Locale::Country to support all three code sets defined by
760 ISO 3166. This was requested by Keith Wall. I haven't added
761 multiple codeset support to the other modules yet - I'll wait until
762 someone asks for them.
763
765 Added Locale::Currency, contribution from Michael Hennecke.
766 Added test suite for it (t/currency.t) and added test cases to
768 t/all.t for the all_* functions.
769
771 Fixed very minor typos from 1.03!
772
774 Updated Locale::Country:
775 - fixed spelling of a few countries
776 - added link to a relevant page from CIA world factbook
777 Updated Locale::Language:
779 - fixed typo in the documentation (ISO 939 should be 639)
780
782 Updated Locale::Country and Locale::Language to reflect changes in
783 the relevant ISO standards. These mainly reflect languages which
784 are new to the relevant standard, and changes in the spelling of
785 some country names.
786 Added official URLs for the standards to the SEE ALSO sections of
788 the doc for each module.
789 Thanks to Jarkko Hietaniemi for pointing me at the pages with
791 latest versions of ISO 3166 and 639.
792
794 Added Locale::Country::_alias_code() so that 'uk' can be added as
795 the code for "United Kingdom", if you want it. This was prompted
796 by Ed Jordan.
797 Added a new test suite for handling this case, and extended the
799 existing test-suite to include testing of the case where 'uk'
800 hasn't been defined as a valid code.
801
803 First public release to CPAN
804
806 Locale::Codes
807
809 See Locale::Codes for full author history.
810 Currently maintained by Sullivan Beck (sbeck@cpan.org).
812
814 Copyright (c) 2001-2010 Neil Bowers
815 Copyright (c) 2010-2022 Sullivan Beck
816 This module is free software; you can redistribute it and/or modify it
818 under the same terms as Perl itself.
819perl v5.34.1 2022-06-02 Locale::Codes::Changes(3)