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