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