JAVA/JS/CPP: v7.0.1 metadata updates.
[platform/upstream/libphonenumber.git] / java / release_notes.txt
index f915803..de374d9 100644 (file)
+Nov 25, 2014: libphonenumber-7.0.1
+* Metadata changes:
+ - New alternate formatting data for country calling code(s): 676
+ - Updated phone metadata for region code(s):
+   BI, CM, ID, IR, KR, LA, NP, TG, TH, TO
+ - New geocoding data for country calling code(s): 237 (en)
+ - Updated geocoding data for country calling code(s): 98 (en, fa)
+ - Updated carrier data for country calling code(s):
+   237 (en), 257 (en), 856 (en), 977 (en)
+
+Oct 29, 2014: libphonenumber-7.0
+* Code changes:
+ - New APIs for ShortNumberInfo. The old APIs have been deprecated and will be
+   removed in an upcoming release.
+* Metadata changes:
+ - Updated phone metadata for region code(s):
+   AR, AU, CC, CI, CX, DZ, EE, IN, KZ, MC, SB, TJ, TT
+ - Updated short number metadata for region code(s): MC
+ - Updated geocoding data for country calling code(s): 34 (en, es), 54 (en)
+ - Updated carrier data for country calling code(s):
+   7 (en), 61 (en), 91 (en), 225 (en), 677 (en), 967 (en), 992 (en), 1868 (en)
+
+Oct 13, 2014: libphonenumber-6.3.1
+* Metadata changes:
+ - Updated phone metadata for region code(s):
+   AC, AU, CR, DE, IL, MR, NO, SA, SR, UG
+ - Updated short number metadata for region code(s): CR
+ - Updated carrier data for country calling code(s):
+   61 (en), 256 (en), 506 (en), 597 (en), 966 (en), 972 (en)
+
+Sep 25, 2014: libphonenumber-6.3
+* Code changes:
+  - Changing the offline geocoder to not return any country at all if the number
+    could belong to multiple countries
+  - Removing obsolete code that treated countries with no metadata as valid.
+* Metadata changes:
+ - New alternate formatting data for country calling code(s): 54, 91
+ - Updated phone metadata for region code(s):
+   AM, AR, BR, CA, CL, IL, IN, IR, IS, KE, NI, PF, SB, SN, TH, TN, US
+ - New geocoding data for country calling code(s):
+   1782 (en), 1929 (en), 1930 (en), 1938 (en)
+ - Updated geocoding data for country calling code(s): 98 (en, fa)
+ - New carrier data for country calling code(s): 354 (en)
+ - Updated carrier data for country calling code(s):
+   27 (en), 56 (en), 66 (en), 91 (en), 92 (en), 98 (en), 216 (en), 221 (en),
+   254 (en), 374 (en), 505 (en), 677 (en), 972 (en)
+
+Aug 21, 2014: libphonenumber-6.2.2
+* Metadata changes:
+ - Updated phone metadata for region code(s): BN, CL, CO, DK, IN, SB, SO
+ - Updated short number metadata for region code(s): FR, SA, US
+ - Updated carrier data for country calling code(s):
+   27 (en), 57 (en), 91 (en), 252 (en), 677 (en)
+
+Jul 28, 2014: libphonenumber-6.2.1
+* Metadata changes:
+ - Updated phone metadata for region code(s): BW, LB, MD, PA, PF, VI, ZM
+ - New carrier data for country calling code(s): 507 (en), 961 (en)
+ - Updated carrier data for country calling code(s): 267 (en), 373 (en)
+
+Jun 30, 2014: libphonenumber-6.2
+* Code changes:
+ - Better exclusion of dates when matching phone numbers from text.
+ - Handle phone input in RFC3966 with missing tel: prefix
+
+* Metadata changes:
+ - New alternate formatting data for country calling code(s): 95
+ - Updated phone metadata for region code(s):
+   AF, CN, EH, FJ, IN, JP, KE, KG, KW, MA, MM, PG, PK, SN, SO
+ - New short number metadata for region code(s): SN
+ - Updated short number metadata for region code(s): FR, KE
+ - Updated geocoding data for country calling code(s): 254 (en)
+ - New carrier data for country calling code(s): 95 (en)
+ - Updated carrier data for country calling code(s):
+   92 (en), 93 (en), 212 (en), 221 (en), 254 (en), 675 (en), 679 (en), 965 (en),
+   996 (en)
+
+Jun 06, 2014: libphonenumber-6.1.1
+* Metadata changes:
+ - Updated phone metadata for region code(s):
+   AF, AG, AI, AS, BB, BF, BM, BS, CA, CN, CR, DM, DO, DZ, FR, GD, GU, IN, JM,
+   KH, KN, KW, KY, LC, MN, MP, MS, NG, NI, PH, PR, SX, TC, TT, US, VC, VG, VI
+ - Updated short number metadata for region code(s): AL
+ - New geocoding data for country calling code(s): 1346 (en), 1959 (en)
+ - Updated geocoding data for country calling code(s):
+   33 (en, fr), 352 (de, en, fr), 355 (en)
+ - New carrier data for country calling code(s): 505 (en)
+ - Updated carrier data for country calling code(s):
+   63 (en), 91 (en), 93 (en), 234 (en)
+
+May 08, 2014: libphonenumber-6.1
+* Code changes:
+ - Adding MetadataLoader support to allow custom metadata loading from
+   alternative sources (should have no visible impact to users).
+ - Fixing bug where digits could be lost in as-you-type formatting and
+   formatting patterns incorrectly applied.
+
+* Metadata changes:
+ - Updated phone metadata for region code(s):
+   AR, BF, BR, BS, CL, CN, CO, CR, DE, DM, EC, EG, FR, GA, GD, GH, HU, ID, IL,
+   IN, JP, KH, KI, KN, LA, LC, LR, ML, MU, MX, MZ, NA, NE, PF, PL, RU, SM, TH,
+   TW, UZ, VA, VC
+ - Updated short number metadata for region code(s): BI, CR, PL, TH
+ - New geocoding data for country calling code(s): 32 (de), 1242 (en)
+ - Updated geocoding data for country calling code(s):
+   32 (en, nl), 55 (en), 56 (en, es), 86 (en, zh)
+ - New carrier data for country calling code(s):
+   1758 (en), 1784 (en), 1869 (en)
+ - Updated carrier data for country calling code(s):
+   66 (en), 86 (en), 227 (en), 231 (en), 233 (en), 258 (en), 1473 (en),
+   1767 (en)
+
+Feb 25, 2014: libphonenumber-6.0
+* Code changes:
+ - Better support for detecting phone numbers in text that are beside each other
+ - Change to how Japanese numbers beginning with "00" are modelled, with the
+   side-effect that the maximum possible number length has been extended by 1.
+ - Handle StringIndexOutOfBoundsException in the AsYouTypeFormatter when the
+   national prefix that was extracted was not found in the prefix. This affected
+   countries with very long carrier codes, such as Korea.
+ - Removal of some of the author attributions - contributions to be tracked in
+   CONTRIBUTORS file.
+* Metadata changes:
+ - Updated phone metadata for region code(s): AS, BR, KW, LU
+ - New carrier data for country calling code(s): 1684 (en)
+ - Updated carrier data for country calling code(s): 352 (en)
+
+Feb 07, 2014: libphonenumber-5.9.4
+* Metadata changes:
+ - Updated phone metadata for region code(s):
+   883, BF, BJ, BW, CL, CR, DZ, FR, GD, IN, JP, MD, NG, NZ, PK, PL, SY, UY, VU
+ - Updated short number metadata for region code(s): LV, MD
+ - New carrier data for country calling code(s): 373 (en), 1473 (en)
+ - Updated carrier data for country calling code(s):
+   48 (en), 49 (en), 91 (en), 92 (en), 213 (en), 226 (en), 229 (en), 234 (en),
+   267 (en), 389 (en), 506 (en), 598 (en)
+
+Jan 21, 2014: libphonenumber-5.9.3
+* Metadata changes:
+ - Updated phone metadata for region code(s):
+   BF, BH, BR, CN, GR, IN, MY, PA, TN, US
+ - Updated short number metadata for region code(s): CN
+ - New geocoding data for country calling code(s): 1364 (en), 1725 (en)
+ - Updated geocoding data for country calling code(s): 86 (en)
+ - Updated carrier data for country calling code(s):
+   55 (en), 226 (en), 973 (en)
+
+Dec 20, 2013: libphonenumber-5.9.2
+* Metadata changes:
+ - New alternate formatting data for country calling code(s): 255, 27, 381, 506
+ - Updated alternate formatting data for country calling code(s): 43
+ - Updated phone metadata for region code(s):
+   AG, AI, AS, BB, BF, BM, BS, CA, CR, DM, DO, EC, GD, GU, JM, KN, KY, LC, MP,
+   MS, PR, SO, SX, TC, TT, US, VC, VG, VI
+ - Updated carrier data for country calling code(s): 226 (en)
+
+Dec 13, 2013: libphonenumber-5.9.1
+* Metadata changes:
+ - New alternate formatting data for country calling code(s): 505, 679
+ - Updated phone metadata for region code(s):
+   BF, CI, EG, EH, FJ, IN, KI, MA, MT, NG, NI, SI, SN, SR, TT
+ - Updated short number metadata for region code(s): KI
+ - Updated geocoding data for country calling code(s):
+   27 (en), 226 (en), 1 (en)
+ - New carrier data for country calling code(s): 356 (en), 677 (en)
+ - Updated carrier data for country calling code(s):
+   212 (en), 221 (en), 225 (en), 226 (en), 234 (en), 597 (en), 1 (en)
+
+Nov 12, 2013: libphonenumber-5.9
+* Code changes:
+ - Adding support for numbers with multiple Italian leading zeros, by adding a field
+   to the phone number proto to allow an arbitrary number of leading zeros, and
+   supporting this when parsing, validating and formatting.
+ - Adding more functionality to ShortNumberInfo -> such as getExpectedCostForRegion.
+ - Fix for parsing short numbers that start with the national prefix.
+ - Updating formatNumberForMobileDialing to work with short numbers.
+ - Stop finding Israeli 4-digit "star" numbers in text when no star is in fact present.
+ - Bug fix for finding phone numbers where the area code was also part of the country
+   calling code.
+
+* Metadata changes:
+ - Updated phone metadata for region code(s):
+   AU, BQ, BY, CI, CO, CW, GN, HN, IN, JO, KI, KW, MG, MK, MM, NA, PK, TC, TM,
+   UG
+ - New short number metadata for region code(s): CD, GN
+ - Updated short number metadata for region code(s):
+   AF, AG, AI, AM, AR, AS, AW, AZ, BD, BH, BI, BM, BO, BQ, BT, BW, BY, CA, CH,
+   CI, CM, CO, CW, DZ, FJ, GD, GE, GH, GT, GY, HN, HT, ID, IE, IM, IN, IQ, JM,
+   JO, KE, KG, KH, KI, KW, KZ, LR, SV
+ - New geocoding data for country calling code(s):
+   257 (en), 389 (en), 599 (en), 686 (en), 962 (en)
+ - Updated geocoding data for country calling code(s):
+   264 (en), 375 (be, en, ru)
+ - New carrier data for country calling code(s):
+   375 (be, ru), 389 (en), 599 (en), 965 (ar)
+ - Updated carrier data for country calling code(s):
+   57 (en), 61 (en), 92 (en), 225 (en), 256 (en), 257 (en), 261 (en), 375 (en),
+   686 (en), 962 (en), 965 (en)
+
+Oct 10, 2013: libphonenumber-5.8.8
+* Metadata changes:
+ - New alternate formatting data for country calling code(s):
+   350, 358, 36, 66, 84, 94, 995
+ - Updated alternate formatting data for country calling code(s):
+   31, 359, 372, 49, 62, 7
+ - Updated phone metadata for region code(s):
+   AR, BD, BE, BF, BR, CO, CR, FI, GI, GM, IS, MU
+ - Updated short number metadata for region code(s): AR, BE, ES, GI, PG, US
+ - Updated geocoding data for country calling code(s): 220 (en)
+ - Updated carrier data for country calling code(s):
+   20 (en), 220 (en), 224 (en), 230 (en), 852 (en)
+
+Oct 8, 2013: libphonenumber-5.8.7
+* Code changes:
+  - New method in the PhoneNumberUtil API - isMobileNumberPortableRegion.
+  - Carrier mapper: Updated API and added a getSafeDisplayName method that only returns the carrier
+                    if it's safe to display to the user.
+
+Oct 7, 2013:
+* Code changes:
+  - Added PhoneNumberToTimeZonesMapper including unittests to the geocoder maven project.
+  - Added build rules for generating the binary time zones mapping file from the text file.
+  - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate time zone mapping.
+* Metadata changes:
+  - Added the time zone mapping file.
+
+Sep 30, 2013:
+* Code changes:
+  - Added PhoneNumberToCarrierMapper including unittests.
+  - Added build rules for generating binary carrier mapping files from text files.
+  - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate carrier mapping.
+* Metadata changes:
+  - Added carrier mapping files for some NANPA countries, EG, SS, MA, DZ, TN, GM, SN, MR, ML, GN,
+    CI, BF, NE, TG, BJ, MU, LR, SL, GH, NG, TD, CF, CM, CV, ST, GQ, GA, CG, CD, AO, GW, SC, SD, RW,
+    ET, SO, DJ, KE, TZ, UG, BI, MZ, ZM, MG, ZW, MW, BW, SZ, ZA, AW, FO, GL, GR, NL, BE, FR, GI, PT,
+    LU, IE, AL, CY, FI, BG, HU, LT, EE, AM, BY, AD, UA, RS, HR, SI, BA, IT, RO, CH, CZ, SK, AT, DK,
+    NO, PL, DE, BZ, CR, PE, CU, AR, BR, CL, CO, VE, BO, PY, SR, UY, MY, AU, ID, PH, NZ, SG, TH, TL,
+    BN, PG, TO, VU, FJ, WS, KI, RU, VN, HK, KH, LA, CN, BD, TR, IN, PK, AF, LK, MV, JO, IQ, KW, SA,
+    YE, OM, PS, AE, IL, BH, QA, BT, NP, IR, TJ, TM, AZ, GE, KG and UZ in English.
+
+Sep 23, 2013: libphonenumber-5.8.6
+* Code changes:
+  - Restructured the geocoder binary generation code, moving the classes under tools/ from
+    geocoding/ to buildtools/ and renaming AreaCode to PhonePrefix.
+
+Sep 23, 2013: libphonenumber-5.8.5
+* Code changes:
+  - Restructured the geocoder, moving the utility classes to a new module internal/prefixmapper.
+
+Sep 20, 2013: libphonenumber-5.8.4
+* Metadata changes:
+ - Adding a token to indicate which countries have mobile portability.
+
+Sep 20, 2013: libphonenumber-5.8.3
+* Code changes:
+  - PhoneNumberOfflineGeocoder: Moved utility functionality to PrefixFileReader.
+  - Bug fix: Argentinian (and other countries with mobile tokens) mobile numbers now geocode
+             correctly.
+
+Sep 19, 2013: libphonenumber-5.8.2
+* Code changes:
+  - New method in the PhoneNumberUtil API - getCountryMobileToken.
+
+Sep 19, 2013: libphonenumber-5.8.1
+* Metadata changes:
+ - New alternate formatting data for country calling code(s): 675
+ - Updated phone metadata for region code(s):
+   AO, AU, BF, BW, CA, CH, CI, CN, DE, FR, MA, MR, MU, NI, PG, SA, SE, US, VI
+ - New short number metadata for region code(s): IQ
+ - Updated short number metadata for region code(s):
+   AU, BR, DO, EG, FR, GH, ID, IL, JM, KE, KZ, LR, MW, NG, NI, SA, SE, SL, TZ, US, UZ
+ - New geocoding data for country calling code(s):
+   966 (ar, en), 1 (en)
+
+Sep 2, 2013: libphonenumber-5.8
+* Code changes:
+ - Renamed ShortNumberUtil to ShortNumberInfo -> the former class is now deprecated and will be
+   deleted in a later release. At the moment it just delegates to ShortNumberInfo.
+ - New methods in the ShortNumberInfo API - isCarrierSpecific, singleton interface,
+   isPossibleShortNumber, isValidShortNumber, getShortNumberCost. Note this is an experimental API
+   at the moment and subject to change.
+ - Bug fixes:
+    -- AsYouTypeFormatting: 3-digit numbers can be formatted as a group where appropriate
+    -- AsYouTypeFormatting: Countries with an optional national prefix were considered before to
+       have always entered it, resulting in bugs where numbers without the national prefix were
+       not properly formatted.
+    -- Numbers in Chile that overlap with emergency numbers are no longer marked as connecting to
+       them
+    -- Not requiring the NDC to be alone for countries where there is no national prefix in strict
+       grouping when extracting phone numbers
+* Metadata changes:
+ - New alternate formatting data for country calling code(s):
+   30, 31, 385, 58, 62, 63, 971, 972
+ - Updated alternate formatting data for country calling code(s): 43, 44, 49
+ - Moved emergency phone number data to the ShortNumberMetadata.xml file
+ - Updated phone metadata for region code(s):
+   AT, EG, ML, NC, NL, SA
+ - New short number metadata for region code(s):
+   AR, CL, CO, ES, MX, NC
+ - Emergency metadata fixes for region code(s):
+   GA, JM, MH, VE
+
+Aug 09, 2013: libphonenumber-5.7.2
+* Metadata changes:
+ - New alternate formatting data for country calling code(s):
+   352, 359, 372, 373, 375, 595, 7, 855
+ - Updated phone metadata for region code(s):
+   AR, BF, BH, BR, BY, CH, CM, CN, GE, GW, HN, JM, KH, LT, LU, MU, NP, RO, SO
+ - New short number metadata for region code(s): BR
+ - Updated short number metadata for region code(s):
+   CH, FJ, GB, GG, IM, IT, JE, SH
+
+Aug 8, 2013: libphonenumber-5.7.1
+* Metadata/code changes:
+ - Change to the way the metadata is built; now only parts of the proto that are relevant will be
+   generated. This means short-code data won't be generated for the normal protos, and fixed-line
+   data won't be generated for short-number protos. This cuts the metadata binary size approximately
+   in half.
+
+Jul 17, 2013: libphonenumber-5.7
+* Code changes:
+ - Improve phone number extraction recall.
+ - Add support for loading short number metadata.
+
+Jul 16, 2013: libphonenumber-5.6.2
+* Metadata changes:
+ - Updated alternate formatting data for country calling code(s): 49, 61
+ - New metadata for region code(s): TA
+ - Updated metadata for region code(s):
+   BF, BH, BI, BJ, BR, CR, EH, GA, GE, GN, GU, IL, IN, IR, KH, KW, KZ, MA, MT,
+   NA, NE, NL, PH, RO, SH, SO, TK
+ - New geocoding data for country calling code(s): 47 (en), 82 (ar)
+ - Updated geocoding data for country calling code(s):
+   49 (en), 98 (en, fa), 241 (en)
+
+Jul 12, 2013: libphonenumber-5.6.1
+* Code changes:
+ - Rename all instances of PhoneNumberMetadata to PhoneNumberMetadata for consistency.
+
+Jun 05, 2013: libphonenumber-5.6
+* Code changes:
+ - Fix for as-you-type-formatting bug affecting countries with no national prefix
+   formatting rule, such as China.
+* Metadata changes:
+ - New alternate formatting data for country calling code(s): 351
+ - Updated alternate formatting data for country calling code(s): 49
+ - Updated metadata for region code(s):
+   AS, BG, BH, BJ, BL, CD, CI, DE, DZ, EH, FJ, GF, GP, IN, KH, KZ, MA, MD, MF,
+   ML, MY, NG, PT, PY, TC, TJ, TT
+
+May 08, 2013: libphonenumber-5.5
+* Code changes:
+ - Changed internal initialization code and made more fields final.
+   Note that we now throw an exception if an attempt is made to set the
+   metadata more than once (which should only happen during testing).
+ - Fix problem with formatNumberForMobileDialing for HU and CL.
+* Metadata changes:
+ - Updated alternate formatting data for country calling code(s): 49
+ - Updated metadata for region code(s):
+   AM, BF, BR, CR, DE, MA, MG, MM, SA, TL, UA
+ - Updated geocoding data for country calling code(s): 374 (am, en, ru)
+
+Apr 19, 2013: libphonenumber-5.4.2
+* Metadata changes:
+ - Updated metadata for region code(s): BF, GA, IN, KR, MV, PH, SO, UA, US
+
+Mar 25, 2013: libphonenumber-5.4.1
+* Metadata changes:
+ - Updated metadata for region code(s): BF, BH, CR, EC, IR, MG, PF, TD, TN
+ - New geocoding data for country calling code(s): 374 (am, ru)
+ - Updated geocoding data for country calling code(s):
+   98 (en, fa), 358 (en, se), 374 (en)
+
+Mar 07, 2013: libphonenumber-5.4
+* Code changes:
+ - Switch formatNumberForMobileDialing to prefer national format to international format when the
+   number is dialed from the same region the phone number is from.
+
+* Metadata changes:
+ - Updated metadata for region code(s):
+   BF, CD, CN, CZ, GN, IR, JP, KR, KW, LR, NZ, TT, UG, ZW
+ - New geocoding data for country calling code(s): 82 (cs)
+ - Updated geocoding data for country calling code(s):
+   82 (en, fr, ko, zh, zh_Hant), 98 (en, fa), 263 (en)
+
+Feb 11, 2013: libphonenumber-5.3.2
+* Metadata changes:
+ - Updated metadata for region code(s):
+   BD, BE, BY, CA, EH, GR, IE, IN, IS, LI, MA, MU, PT, SE, SG, TL
+ - New geocoding data for country calling code(s):
+   375 (be, en, ru), 1 (en)
+
+Jan 25, 2013: libphonenumber-5.3.1
+* Metadata changes:
+ - Updated metadata for region code(s): CN, DK, EH, GN, KH, KW, MA, MY, PA
+
+Jan 08, 2013: libphonenumber-5.3
+* Code changes:
+ - Handling UAN numbers in Argentina better when dialling them locally from a
+   mobile
+* Metadata changes:
+ - Updated metadata for region code(s):
+   BE, BW, CL, CN, CO, EH, KW, MA, ML, NG, PL, SY, ZA, ZM
+ - New geocoding data for country calling code(s): 32 (en, fr, nl)
+ - Updated geocoding data for country calling code(s): 27 (en), 86 (en, zh)
+
+Dec 06, 2012: libphonenumber-5.2.2
+* Metadata changes:
+ - New metadata for region code(s): EH
+ - Updated metadata for region code(s): BR, CL, CR, IN, MA, PG, PK, RO
+ - New geocoding data for country calling code(s): 241 (en)
+
+Nov 26, 2012: libphonenumber-5.2.1
+* Metadata changes:
+ - Updated metadata for region code(s):
+   AE, AW, BF, CN, DE, JO, KE, KH, LT, MM, MU, NG, RW, SR, TR, VU
+ - New geocoding data for country calling code(s): 359 (bg, en)
+
+Oct 10, 2012: libphonenumber-5.2
+* Code changes:
+ - Adds isNumberGeographical() method.
+ - Adds getRegionCodesForCountryCode() method.
+ - Fixing issue with getSupportedGlobalNetworkCallingCodes()
+   [http://code.google.com/p/libphonenumber/issues/detail?id=202]
+ - Ensures that returned collections are unmodifiable where necessary
+   [there is a very slight risk that this may break existing users who were relying on being able
+   to modify these collections, but doing so would be breaking lots of other assumptions that this
+   library makes - if you need to modify any affected collections you must copy them first]
+* Metadata changes:
+ - Updated metadata for region code(s): DE, GR, HR, OM, SB, ZA
+ - Removed metadata for region code: AN (Netherlands Antilles)
+ - Updated geocoding data for country calling code(s): 30 (el, en)
+
+Sep 27, 2012: libphonenumber-5.1.4
+* Metadata changes:
+ - Updated metadata for region code(s): AU, EC, KH, LB, TN, US
+
+Sep 17, 2012: libphonenumber-5.1.3
+* Metadata changes:
+ - Updated metadata for region code(s): EG, LA, LB, LI, PY
+ - Updated metadata for non-geographical calling codes: 800, 808, 888, 979
+ - Updated geocoding data for country calling code(s): 98 (en), 1 (en)
+
+Sep 11, 2010: libphonenumber-5.1.2
+* Bug fix:
+ - Fixing regression in AsYouTypeFormatter where it no longer worked for numbers entered in national
+   format for countries with no national prefix, e.g. Spain.
+
+Sep 5, 2010: libphonenumber-5.1.1
+* Code changes:
+  - Added better logging/exception handling for catching cases where metadata is invalid/missing.
+
+Sep 3, 2012: libphonenumber-5.1
+* Code changes:
+ - Inserting a space after the national prefix in the AsYouTypeFormatter when formatting numbers in
+   national format, if the formatting rules for that country dictate that a space is appropriate.
+ - Format emergency numbers and short-codes as a block in the AsYouTypeFormatter.
+* Metadata changes:
+ - Updated metadata for region code(s): BF, BG, DZ, GA, IT, JP, KW, PF
+
+Aug 20, 2012: libphonenumber-5.0.3
+* Metadata changes:
+ - New alternate formatting data for country calling code(s): 43
+ - Updated metadata for region code(s): AT, BF, JO, NG, RU, SL
+ - New geocoding data for country calling code(s): 62 (en, id), 98 (fa)
+
+Aug 07, 2012: libphonenumber-5.0.2
+* Metadata changes:
+ - Updated metadata for region code(s):
+   BF, CN, DJ, IL, JO, KH, KZ, MA, MT, MV, MY, NC, NG, SD, SK, SN, TL, UZ
+ - New geocoding data for country calling code(s): 7 (ru), 98 (en)
+ - Updated geocoding data for country calling code(s): 7 (en)
+
+July 26th, 2012: libphonenumber-5.0.1
+* Metadata changes
+ - CL, DE ,IN, KR, US
+ - New geocoding data for country calling codes 40, 57, 66, 82, 91.
+ - Fixed comments for 353 (IE).
+
+July 12th, 2012: libphonenumber-5.0
+* Code changes:
+ - Support for alternate formats when finding phone numbers.
+ - Allowing two-digit numbers to be parsed if they are entered in national-format with no
+   punctuation
+* Metadata changes
+ - IL, GA
+* Other
+ - Reflowed this file to 100 char width to make it unambiguous as to what the standard should be.
+
+July 6th, 2012: libphonenumber-4.9.1
+* Metadata changes
+ - AR, BA, BF, CR, DE, EC, ES, KZ, MK, NC, NG, PF, SB, UZ, non-geo entity 882
+ - Geocoding data updates for country calling codes 54 (AR) and 81 (JP), new data for 234 (NG)
+
+June 21st, 2012: libphonenumber-4.9
+* Bug fix
+ - formatInOriginalFormat fixed not to add a star sign if it was not present originally.
+* Metadata changes
+ - BF, CZ, ES, KW
+ - Non-geographical entities with calling code 882 (BebbiCell, Maritime Communications, Oration
+   Technologies, Telespazio and Thuraya)
+ - Geocoding data updates for country calling codes 221, 224, 226, 242, 244, 245
+* Functionality changes:
+ - Minimum allowed length for a national significant number (NSN) when parsing changed from 3 to 2.
+ - Support parsing of RFC3966-formatted strings with an isdn-subaddress or extra parameters
+   specified.
+ - Allow soft hyphen to appear in phone numbers (\u00AD)
+* Testing changes:
+ - Add extra unit tests for non-geographical phone number entities
+ - ExampleNumbersTest testEmergency tests now uses ShortNumberUtil
+
+June 14th, 2012: libphonenumber-4.8.5
+* Metadata update only:
+ - AC, CR, DE, DK, IL, IN, IS, KH, LI, LR, MA, MD, MK, PA, SA, SG, SS
+
+June 6th, 2012: libphonenumber-4.8.4
+* Metadata update only:
+ - AE, RO
+ - Non-geographical entity with calling code 881 (Iridium)
+
+May 30th, 2012: libphonenumber-4.8.3
+* Metadata update only:
+ - AN, ET, KW, MN, SX, TC, TL
+
+May 16th, 2012: libphonenumber-4.8.2
+* Metadata update only:
+ - BH, CR, EE, JO, KW, LA, QA, SI, TH
+ - Non-geographical entity with calling code 878 (VISIONng)
+
+May 8th, 2012: libphonenumber-4.8.1
+* Metadata update only:
+ - CA, CI, EG, HK, IN, IR, LB, MA, ME, MM
+ - Non-geographical entity with calling code 870 (Inmarsat)
+ - Geocoding updates for country calling codes 1 for new area codes
+
+April 24th, 2012: libphonenumber-4.8
+* Functionality changes
+ - RFC format now outputs a number starting with "tel:"
+ - Parsing support for numbers in RFC format that contain the country info in the "phone-context"
+   part
+ - Support for obtaining area codes for Italy, Vatican City, San Marino
+* Metadata changes
+ - AM, AO, AR, BE, BF, CD, EG, GH, GM, GN, IN, IR, IT, JO, LA, LC, MD, MS, NO, PA, PK, SI, SJ, SO,
+   SY, TC, TN, UZ, VN, ZW
+ - Geocoding updates for country calling codes 1, 20, 233, 31, 33, 352, 374, 54, 56, 86
+* Refactoring of matching functions, including moving them to PhoneNumberMatcher.
+
+March 16th, 2012: libphonenumber-4.7
+* Bug fixes
+ - Now return "too long" for input that is longer than 250 chars when parsing
+* Metadata changes
+ - AC,AM,AT,AZ,BF,BR,BY,BZ,CR,CU,DE,DJ,EE,EG,ET,GA,GH,HK,HN,ID,IN,JP,KE,KG,KH,KR,KW,KY,LB,LU,MA,MD,
+   MK,NA,NE,NZ,SA,SB,SC,SE,SL,SN,UZ
+* Refactoring of test classes so that tests requiring the test metadata to be loaded have a common
+  base class which handles this.
+
+February 9th, 2012: libphonenumber-4.6
+* Bug fixes
+ - Fix for formatByPattern to enable RFC formatting to work
+ - Fix for RFC formatting to work even when the international formatting rule starts with
+   punctuation
+ - Logging consistency changes - some warnings are no longer printed, others have become only
+   WARNINGS
+ - Fix for isValidNumberForRegion potentially throwing a NPE
+ - Parsing Israeli * numbers written in international format now works
+ - PhoneNumberMatcher doesn't match timestamps as phone-numbers
+* Metadata changes
+ - Updates for AN, AX, BF, BJ, BR, BS, DJ, FI, IN, LV, MW, RS, SC, VN
+ - New countries supported: SS (South Sudan), CW (CuraƧao) and BQ (Bonaire, Sint Eustatius and Saba)
+* Refactoring of the private formatting functions in PhoneNumberUtil to ensure names are more
+  descriptive and to reduce code duplication.
+
+January 19th, 2012: libphonenumber-4.5
+* Code changes
+ - Support for non-geographical country calling codes (e.g. +800).
+ - Modify formatInOriginalFormat to not insert/remove/modify digits in the original number passed
+   in.
+ - Fix formatOutOfCountryKeepingAlphaChars to not throw a NPE.
+
+* Metadata changes
+ - Updates for AR, BH, CI, CN, CR, DE, GA, IL, JO, JP, KE, KZ, LB, LK, LT, MV, MW, MZ, NA, NL, NZ,
+   PL, RO, SA, SV, TM, UG, US
+ - New country calling codes: 800, 808, 883, 888, 979
+ - Geocoding data updates: AR, US
+
+December 9th, 2011: libphonenumber-4.4
+* Code changes
+ - Support for Voicemail numbers
+ - Support prefixes "xt" and "xtn" to indicate extensions of phone numbers
+ - Change formatInOriginalFormat to use raw_input for numbers with incorrect leading zeroes, instead
+   of all invalid numbers.
+
+* Metadata changes
+ - Updates for AR, BD, CH, CI, IL, IR, IS, IT, JP, KW, LR, MM, NG, SA, SC, UZ
+
+November 24th, 2011: libphonenumber-4.3
+* Code changes
+ - Fix the problems with AYTF crashing for longer numbers entered with +CountryCode, and incorrectly
+   removing national prefix for some numbers.
+ - Improve PhoneNumberMatcher to not match numbers ending with '%'.
+ - Fix formatNumberForMobileDialing to handle Israeli star numbers, Peruvian and Colombian numbers.
+ - Modify formatInOriginalFormat to use the raw input if we don't have a formatting pattern for a
+   number.
+ - Simple offline geocoding function which takes into account the user's region.
+
+* Metadata changes
+ - Updates for CR, GN, JP, KE, PL, SG, SR, SX, TH, TK
+
+November 10th, 2011: libphonenumber-4.2
+* Code changes
+ - Providing an "exact match" isEmergencyNumber method
+ - Improvement to PhoneNumberMatcher: requires national prefix to be present when matching
+   national-format numbers, unless matching for a region where it is explicitly marked in the
+   metadata that they may be omitted. Applies to leniency level VALID and higher.
+ - Change formatNumberForMobileDialing not to modify the phoneNumber passed in.
+
+* Metadata changes
+ - Emergency numbers added for all remaining countries
+ - Collected data on which numbers we format with a national prefix are commonly written without one
+   and added this
+ - Updates for AR, AT, BH, CZ, GR, IR, KM, LT, MX, PT, SE, SO, UG
+ - Addition of SX (Sint Maarten)
+
+October 19th, 2011: libphonenumber-4.1
+* Code changes
+ - Update code and metadata for countries with IDD "8~10" to accept phone numbers where the "~" is
+   omitted.
+ - Modify formatInOriginalFormat to use raw_input (when present) when the number is considered as
+   invalid by the library.
+ - Add ShortNumberUtil to deal with international short phone numbers, such as short codes and
+   emergency numbers.
+ - Increase the maximum phone-number length accepted when parsing (now set to
+   16).
+
+* Metadata changes
+ - Updates: BF, BN, CN, DE, DK, DO, FR, IN, KI, KW, MC, MD, ML, PA, QA, SB, UK, WS
+ - Emergency number information also added to: AE, AF, AL, AM, AR, AT, AU, BA,
+   BB, BD, BE, BG, BH, BO, BR, BY, CA, CH, CL, CN, CO, CR, CY, CZ, DE, DJ, DK,
+   DO, DZ, EC, EE, EG, ES, FI, FJ, FO, FR, GB, GE, GF, GH, GI, GL, GR, GT, GY,
+   HK, HN, HR, HU, ID, IE, IL, IN, IR, IS, IT, JM, JO, JP, KR, KW, KY, KZ, LB,
+   LK, LT, LU, LV, MA, MC, MD, ME, MK, ML, MM, MN, MO, MT, MU, MV, MX, MY, NG,
+   NI, NL, NO, NP, OM, PA, PE, PH, PK, PL, PM, PT, PY, QA, RO, RS, RU, RW, SA,
+   SB, SD, SE, SG, SI, SK, SL, SM, SR, SV, SY, TD, TH, TJ, TM, TN, TR, TT, TW,
+   UA, UG, US, UY, UZ, VA, VE, VN, VU, ZA, ZM, ZW
+
+October 6th, 2011: libphonenumber-4.0
+* Code changes
+ - New function formatNumberForMobileDialing, which attempts to format a number in such a way that
+   the call can be connected from a mobile phone. If this is impossible, for example for numbers
+   that cannot be internationally dialled, then an empty string is returned.
+ - Fallback functionality to English for non-CJK languages for geocoding
+
+* Metadata changes
+ - Collecting data for emergency numbers
+ - Updates: AR, AU, BR, CN, CZ, EG, GD, IE, IL, JM, KW, KH, SD, SO, TR, UG, UZ
+ - Geocoding data changes: AO, AR, AT, BJ, BR, CD, CG, CI, CL, CN, CV, DE, ES,
+   FR, GR, GW, HU, KM, MR, MZ, NL, PL, PT, SE, ST, SZ
+
+September 13th, 2011: libphonenumber-3.9
+* Code changes
+ - Enable AsYouTypeFormatter to handle long IDD and NDD.
+ - Allow the presence of an IDD following a +.
+ - Fix formatting of phone numbers which contain only 0s in the national number.
+ - Refactored some code in geocoding including AreaCodeMap and the storage strategies.
+
+* Metadata changes
+ - Updates: AM, BE, BH, BJ, BR, BT, BZ, CI, CL, CN, DE, DK, DM, DZ, EC, EG, FJ,
+   GR, HR, HT, IN, IQ, IS, JM, KE, KG, KH, KR, LA, LB, LR, MA, MD, ML, MO, MX,
+   MY, NE, NG, PG, PH, PK, PY, QA, SA, SD, SG, SN, TD, TG, TH, TN, TT, UG, YE,
+   ZA, ZM
+ - New geocoding data for: AC, CG, CU, CV, EG, ET, FI, FI, FI, GL, JP, KM, MA,
+   MA, MU, MU, MU, MZ, RS, SH, SH, SL, SO, ST, TG, TG, TG, UG, ZM
+ - Updated geocoding data for: AR, DE
+
 August 11th, 2011: libphonenumber-3.8
 * Code changes
  - Fix to demo to not throw null-ptr exceptions for invalid NANPA numbers
  - Fixed AYTF to not accept plus signs in the middle of input
- - PhoneNumberMatcher improvements - added STRICT_GROUPING and EXACT_GROUPING
-   levels, numbers followed/preceded by a currency symbol will not match,
-   multiple numbers separated by phone-number punctuation will now match. ", "
-   is no longer accepted as an extension symbol when matching, only when
-   parsing. "x" is only accepted as a carrier code or extension marker, not
-   otherwise.
- - Changes to handling of leading zeroes - these will not be silently ignored
-   anymore, but will be stored as part of the number.
- - PhoneNumberOfflineGeocoder - new method to get the description of a number that assumes
-   the validity of the number has already been checked and will not re-verify it.
+ - PhoneNumberMatcher improvements - added STRICT_GROUPING and EXACT_GROUPING levels, numbers
+   followed/preceded by a currency symbol will not match, multiple numbers separated by phone-number
+   punctuation will now match. ", " is no longer accepted as an extension symbol when matching, only
+   when parsing. "x" is only accepted as a carrier code or extension marker, not otherwise.
+ - Changes to handling of leading zeroes - these will not be silently ignored anymore, but will be
+   stored as part of the number.
+ - PhoneNumberOfflineGeocoder - new method to get the description of a number that assumes the
+   validity of the number has already been checked and will not re-verify it.
  - Split geocoding US binary data into multiple files.
 
 * Metadata changes
@@ -269,16 +941,16 @@ August 16th, 2010
 August 4th, 2010
 * Further improve startup performance
   - Preload no country specific metadata at startup.
-  - Stop creating the file containing mapping from country calling code to region code
-    and loading it at startup; instead, do the initialization in PhoneNumberUtil.
+  - Stop creating the file containing mapping from country calling code to region code and loading
+    it at startup; instead, do the initialization in PhoneNumberUtil.
 
 July 31th, 2010
 
 * Improve startup performance
   - Separate generated metadata binary file to one file per region
   - Preload US at start up, and load other region at the time when needed
-  - Create a file containing mapping from country calling code to region code,
-    and load it at startup
+  - Create a file containing mapping from country calling code to region code, and load it at
+    startup
   - Same change also applied to unittests
 
 July 30th, 2010