node-phonenumber/lib/libphonenumber/release_notes.txt

Google's phone number handling library ported to Node

Dec 06, 2017: v8.8.8
Metadata changes:
 - Updated phone metadata for region code(s): JM, MY
 - Updated short number metadata for region code(s): US, ZA
 - Updated carrier data for country calling code(s):
   86 (en, zh, zh_Hant), 98 (en, fa)

Nov 28, 2017: v8.8.7
Build changes:
 - C++ library can now be built as 32- and 64-bit RPMs (#643).
Metadata changes:
 - Updated phone metadata for region code(s):
   AX, CC, CX, EH, FI, GU, HK, IN, IR, MA, SM, ZM
 - Updated short number metadata for region code(s): AU, HR
 - Updated carrier data for country calling code(s):
   7 (en, ru), 27 (en), 91 (en), 212 (en), 852 (en, zh, zh_Hant)

Nov 14, 2017: v8.8.6
Metadata changes:
 - Updated alternate formatting data for country calling code(s):
   34, 62, 91, 94, 971, 972
 - Updated phone metadata for region code(s):
   AE, AR, AU, BB, BN, BR, BW, BY, BZ, CC, CL, CW, CX, DE, EC, EG, ET, GB, GE,
   GG, GP, HK, HR, ID, IE, IL, IN, JO, KH, LK, LU, LV, LY, MG, MO, MR, MY, NL,
   NR, OM, PH, PK, PM, PS, RE, RU, RW, SA, SE, SG, SH, SK, SM, TH, TJ, UZ, VN,
   ZM, ZW
 - New geocoding data for country calling code(s): 61 (en)
 - Updated geocoding data for country calling code(s): 20 (en)
 - New carrier data for country calling code(s): 674 (en)
 - Updated carrier data for country calling code(s):
   61 (en), 91 (en), 234 (en), 593 (en), 1246 (en)
 - Updated / refreshed time zone meta data.

Oct 30, 2017: v8.8.5
Metadata changes:
 - Updated phone metadata for region code(s): AW, CA, CN, MV, NL, TR, UG
 - Updated short number metadata for region code(s): TR
 - Updated carrier data for country calling code(s):
   86 (en, zh, zh_Hant), 297 (en)

Oct 16, 2017: v8.8.4
Build changes:
 - C++ geocoding build tools now use readdir, since readdir_r is deprecated.
 - Update the protobuf-java dependency used to build the C++ metadata from 2.5.0
   to 3.0.0. This is an internal change and does not affect the users of the
   library.
Metadata changes:
 - Updated phone metadata for region code(s): AL, BS, FJ, JM, PH, US
 - Updated short number metadata for region code(s): KZ
 - New geocoding data for country calling code(s): 1726 (en)
 - Updated geocoding data for country calling code(s): 1242 (en)
 - Updated carrier data for country calling code(s):
   20 (en), 679 (en), 1242 (en)

Oct 03, 2017: v8.8.3
Metadata changes:
 - Updated phone metadata for region code(s): BS, FJ, IR, KR
 - Updated short number metadata for region code(s): KR
 - Updated carrier data for country calling code(s):
   380 (en), 381 (en), 679 (en), 1242 (en)

Sep 19, 2017: v8.8.2
Metadata changes:
 - Updated phone metadata for region code(s):
   CA, CR, EG, FI, HN, IS, KM, KR, LU, MV, PA, TW, UG, US, VN
 - Updated short number metadata for region code(s): IE, IR, KE, TR
 - New geocoding data for country calling code(s): 1223 (en)
 - Updated geocoding data for country calling code(s): 84 (en, vi)
 - Updated carrier data for country calling code(s): 20 (en)

Sep 05, 2017: v8.8.1
Metadata changes:
 - Updated phone metadata for region code(s):
   AL, AR, AT, AU, AX, AZ, BO, BR, CN, CO, DE, EG, FI, GB, GL, GW, ID, IE, IL,
   IM, IN, JP, KI, KR, KW, LB, LI, LU, MV, MW, NA, NE, NG, PK, PY, SE, SI, SK,
   SO, SR, TJ, TW, UA, UG, US, VN, ZW
 - Updated short number metadata for region code(s): KR
 - New geocoding data for country calling code(s): 380 (en), 1838 (en)
 - Updated geocoding data for country calling code(s): 84 (en, vi), 686 (en)
 - Updated carrier data for country calling code(s):
   60 (en), 380 (en), 597 (en), 686 (en)

Aug 21, 2017: v8.8.0
Code changes:
 - Improve parsing logic to be smarter about national-prefix detection &
   stripping based on possible-lengths (IS_POSSIBLE_LOCAL_ONLY and
   INVALID_LENGTH). Enables e.g. adding Iran short-codes starting with "096"
   without the need to hack IR's national prefix parsing config.
 - Logging changes: Don't log client-provided phone numbers.
 - Add constants for C++ PhoneNumberUtil enums' max values.
Metadata changes:
 - Updated phone metadata for region code(s):
   AX, BF, BG, DM, EG, FI, IN, IR, KY, KZ, LC, MT, NI, PL, RU, SZ, TH, US, VC
 - Updated short number metadata for region code(s): BA, IR, PL, RU, TH, ZA
 - New geocoding data for country calling code(s): 52 (es), 1986 (en)
 - Updated geocoding data for country calling code(s): 52 (en), 268 (en)
 - New carrier data for country calling code(s): 1345 (en)
 - Updated carrier data for country calling code(s):
   20 (en), 226 (en), 268 (en), 356 (en), 505 (en), 1441 (en), 1758 (en),
   1767 (en), 1784 (en)

Aug 02, 2017: v8.7.1
Code changes:
 - Documentation fix for getNumberType
Metadata changes:
 - Updated phone metadata for region code(s):
   AG, AM, BJ, BO, CL, EE, EG, GD, HK, IN, KE, KW, LK, US
 - Updated short number metadata for region code(s): BJ, EE, EG, IN, KW
 - New geocoding data for country calling code(s): 1564 (en)
 - New carrier data for country calling code(s): 1268 (en)
 - Updated carrier data for country calling code(s):
   56 (en), 254 (en), 374 (en), 852 (en, zh, zh_Hant), 1473 (en)
 - Updated / refreshed time zone meta data.

Jul 18, 2017: v8.7.0
Code changes:
 - New method getSupportedCallingCodes() API to return all the calling codes
   that the library considers valid, both for geographical and non-geographical
   entities.
 - Added isSmsServiceForRegion(PhoneNumber, RegionCode) API in C++ and Java
   short number info libraries. An SMS service is where the primary or only
   intended usage is to receive and/or send text messages (SMSs). This includes
   MMS as MMS numbers downgrade to SMS if the other party isn't MMS-capable. The
   is_sms_service metadata is also serialized for the first time.  JS is not
   affected because it doesn't have short numbers.
 - Documentation update for private variables VALID_PUNCTUATION and
   SINGLE_INTERNATIONAL_PREFIX, also renaming the latter from
   UNIQUE_INTERNATIONAL_PREFIX.
 - [Java only] Changing public APIs that take in strings representing phone
   numbers or parts of phone numbers to take in CharSequence instead. Updating
   some of the internal methods to do the same. This affects ShortNumberInfo and
   PhoneNumberUtil, namely the following methods:
   - parse & parseAndKeepRawInput
   - formatWithCarrierCode & formatWithPreferredCarrierCode
   - isNumberMatch
   - isPossibleNumber
   - isAlphaNumber
   - normalizeDigitsOnly & normalizeDiallableCharsOnly
 - [C++ only] Removing most of the "using std::*" statements in
   phonenumberutil.h file, leaving only using std::string. Changing the .cc and
   test files to prefix "std::" where this was missing.
Metadata changes:
 - New alternate formatting data for country calling code(s): 856
 - Updated phone metadata for region code(s):
   BF, FI, GG, HK, IM, JE, KG, LA, MX, MY, PS, SA, VN, ZW
 - New short number metadata for region code(s): PS
 - Updated short number metadata for region code(s): TR, ZA
 - New geocoding data for country calling code(s): 52 (en), 976 (en)
 - Updated geocoding data for country calling code(s):
   84 (en, vi), 223 (en), 358 (en, fi, sv)
 - Updated carrier data for country calling code(s):
   40 (en), 44 (en), 91 (en), 226 (en), 966 (en), 996 (en)
 - Updated / refreshed time zone meta data.

Jul 04, 2017: v8.6.0
Code changes:
 - Removing leading_zero_possible from the metadata and all the places it is
   referenced in the build and prod code. Will be removed from the metadata
   proto itself in a subsequent release. This should not affect users of the
   library - the only place it was used was FormatInOriginalFormat, and only
   initially to try and avoid modifying the input number by removing/adding
   digits inadvertently. Now this is checked at the end of the method anyway.
   However slight formatting differences with this method on invalid numbers
   starting with 0s may be noticed in some countries.
 - Bug fix for Javascript: getNationalSignificantNumber used to print the string
   "null" for empty phone number objects, now it returns an empty string.
 - Updated the documentation for the isNumberGeographical API.
 - Small comment improvements for parse() method to point users at
   parseAndKeepRawInput().
 - Added a new enum for CountryCodeSource called UNSPECIFIED. This is used as a
   default value, and will be returned if someone calls parse() and then
   getCountryCodeSource() on the result. If users want an actual value for this
   then they should call parseAndKeepRawInput() instead; the values that were
   previously returned after calling this method will not change.
 - Deletion of the possible number pattern in the phonemetadata.proto file and
   all generated code. This has not been used for a long time.
Metadata changes:
 - Updated phone metadata for region code(s): AU, IL, IM, IN, KE, MM, PM, UA
 - Updated geocoding data for country calling code(s): 95 (en)
 - New carrier data for country calling code(s): 508 (en)
 - Updated carrier data for country calling code(s):
   95 (en), 254 (en), 972 (en)

Jun 20, 2017: v8.5.2
Metadata changes:
 - New alternate formatting data for country calling code(s): 64
 - Updated phone metadata for region code(s):
   AL, AX, BR, CM, FI, GE, GI, IE, IN, IR, JO, LA, LR, MK, NZ, PK, SI, TL, UA
 - Updated short number metadata for region code(s): IR, TH, ZA
 - New carrier data for country calling code(s): 503 (en)
 - Updated carrier data for country calling code(s):
   91 (en), 213 (en), 386 (en), 389 (en), 509 (en), 995 (en)

Jun 06, 2017: v8.5.1
Metadata changes:
 - Updated phone metadata for region code(s):
   BA, BL, GB, GF, GP, GU, KW, MF, PG, PL, RE, VN, YT, ZW
 - Updated short number metadata for region code(s): IR, PG
 - Updated geocoding data for country calling code(s):
   84 (en, vi), 263 (en), 675 (en)
 - New carrier data for country calling code(s): 262 (en), 590 (en), 594 (en)
 - Updated carrier data for country calling code(s):
   48 (en), 387 (en), 675 (en), 1 (en)

May 23, 2017: v8.5.0
Code changes:
 - Add canBeInternationallyDialled() public API in Java and C++ PhoneNumberUtil.
   This was already in JS.
Build changes:
 - When compiling binary metadata from XML metadata, we no longer set the
   national number pattern  to "NA" for non-existent data.
Metadata changes:
 - Updated phone metadata for region code(s): BF, GB, IL, IM, MQ, SL, US, VN
 - Updated short number metadata for region code(s): BO, BR
 - Updated geocoding data for country calling code(s): 1 (en), 84 (en, vi)
 - New carrier data for country calling code(s): 596 (en)
 - Updated carrier data for country calling code(s): 232 (en), 972 (en)

May 10, 2017: v8.4.3
Metadata changes:
 - Updated phone metadata for region code(s):
   AX, BF, CG, FI, GG, GH, GI, IM, IR, JE, JM, VN
 - Updated short number metadata for region code(s): AX, BR, FI, GI, HK
 - Updated geocoding data for country calling code(s): 84 (en), 233 (en)
 - Updated carrier data for country calling code(s):
   233 (en), 358 (en), 1876 (en)

Apr 25, 2017: v8.4.2
Code changes:
 - Small fix for possible out-of-bounds exception on RFC3966 input where no
   phone context was actually provided.
Metadata changes:
 - Updated phone metadata for region code(s): BF, ET, IN, KE, LU, VN
 - Updated short number metadata for region code(s): KE
 - Updated carrier data for country calling code(s):
   84 (en), 91 (en), 226 (en), 251 (en), 254 (en), 352 (en)

Apr 11, 2017: v8.4.1
Code changes:
 - Changing isPossibleWithReason to return the enums INVALID_LENGTH and
   IS_POSSIBLE_LOCAL_ONLY, where these apply. isPossibleNumber continues to
   consider IS_POSSIBLE or IS_POSSIBLE_LOCAL_ONLY numbers as possible to dial.
   Announcement: https://groups.google.com/d/msg/libphonenumber-discuss/sPhYzdzFCmg/6tYsS1f6DgAJ
 - Doc updates for getRegionCodeForNumber to clarify that it does not
   work for short-codes or invalid numbers.
Metadata changes:
 - Updated phone metadata for region code(s):
   AF, AL, CI, CL, DE, HT, IL, MP, VN
 - Updated short number metadata for region code(s): CZ, DE
 - Updated geocoding data for country calling code(s): 84 (en, vi)
 - Updated carrier data for country calling code(s):
   84 (en), 93 (en), 225 (en), 509 (en), 972 (en)
 - Updated / refreshed time zone meta data.

Mar 28, 2017: v8.4.0
Code changes:
 - Doc changes to update references to ISO country codes to CLDR region codes,
   which are what we actually use. Notice in some of the mapper files the
   country code is still the ISO one, because it's used as part of a description
   of a language only (e.g. zh-TW vs zh-CN). Edited the language comments there
   since they can be two *or* three letters (c.f. fil for filipino). Also edited
   the comment for leadingDigits at the territory level in the
   phonemetadata.proto file.
 - New API methods: isPossibleNumberForType and
   isPossibleNumberForTypeWithReason, along with getSupportedTypesForRegion and
   getSupportedTypesForNonGeoEntity. These allow you to query which types (e.g.
   Mobile) exist for a particular region, and work out if a number is possible
   for that type (this is a simple length check) rather than for the region as a
   whole.
Metadata changes:
 - Updated phone metadata for region code(s): BF, FJ, GB, HK, HT, IN, RO
 - Updated short number metadata for region code(s): BR, IN, RO, TR
 - Updated geocoding data for country calling code(s): 82 (hi, iw, tr)
 - Updated carrier data for country calling code(s):
   226 (en), 509 (en), 593 (en), 679 (en)

Mar 14, 2017: v8.3.3
Code changes:
 - Doc fix for PhoneNumberOfflineGeocoder to explain the cases where an empty
   string might be returned.
Metadata changes:
 - Updated phone metadata for region code(s):
   AG, AI, AS, BB, BF, BM, BQ, BS, BW, CA, DM, DO, ES, GD, GU, HK, HR, IN, JM,
   JO, KN, KY, LC, ME, MP, MS, MX, PH, PR, SR, SX, TC, TH, TT, US, VC, VG, VI
 - Updated short number metadata for region code(s): ES, HR
 - Updated geocoding data for country calling code(s):
   34 (en, es), 84 (vi), 91 (en)
 - New carrier data for country calling code(s): 264 (en)
 - Updated carrier data for country calling code(s):
   55 (en), 63 (en), 66 (en), 91 (en), 233 (en), 599 (en)

Feb 28, 2017: v8.3.2
Metadata changes:
 - Updated phone metadata for region code(s): BS, CI, HT, IL, IN, IS, KE, SK
 - Updated short number metadata for region code(s): KE
 - Updated geocoding data for country calling code(s): 254 (en)
 - Updated carrier data for country calling code(s):
   91 (en), 225 (en), 254 (en), 354 (en), 509 (en), 1242 (en)

Feb 20, 2017: v8.3.1
Code changes:
 - Making getNationalSignificantNumber more robust in the face of malicious
   input. This now ignores the number_of_leading_zeros if they are less than
   zero.
Metadata changes:
 - New alternate formatting data for country calling code(s): 39
 - Updated phone metadata for region code(s): BS, VN
 - Updated geocoding data for country calling code(s):
   62 (en, id), 84 (en), 374 (en, hy)
 - Updated carrier data for country calling code(s): 7 (ru), 91 (en), 1242 (en)
 - Updated / refreshed time zone meta data.

Feb 14, 2017: v8.3.0
Code changes:
 - Added two new enum values to ValidationResult - IS_POSSIBLE_LOCAL_ONLY and
   INVALID_LENGTH. Added more documentation to the existing values; see the
   javadoc for when these are going to be used. Note that the API for
   IsPossibleNumberWithReason has not yet been changed to return these values.
   IS_POSSIBLE_LOCAL_ONLY will be returned for some values which currently
   return IS_POSSIBLE, and INVALID_LENGTH will be returned for some values which
   currently return TOO_LONG.
 - Fix for isNumberMatch to ignore the numberOfLeadingZeros field when comparing
   numbers unless hasItalianLeadingZero is true, and to consider default values
   to match the same value when explicitly set for these two fields. This fix
   shouldn't be needed for anyone correctly creating phone numbers using "parse"
   as recommended.
 - C++ only: Fix for ExactlySameAs when comparing phone numbers to include
   comparison of the number_of_leading_zeros field.
 - C++ only: Updating maximum length for NSN to be 17 (matches Java and JS)
Metadata changes:
 - Updated phone metadata for region code(s): IN, MU, RE, TG, TJ, TT, US
 - New geocoding data for country calling code(s):
   218 (en), 972 (iw), 1283 (en), 1442 (en), 1458 (en), 1470 (en), 1475 (en),
   1531 (en), 1534 (en), 1539 (en), 1680 (en), 1681 (en), 1762 (en)
 - Updated geocoding data for country calling code(s):
   1206 (en), 1253 (en), 1360 (en), 1425 (en), 1509 (en)
 - Updated carrier data for country calling code(s):
   57 (en), 91 (en), 297 (en), 992 (en), 1868 (en)

Feb 02, 2017: v8.2.0
Code changes:
 - Made normalizeDiallableCharsOnly() API in PhoneNumberUtil (Java) public. This
   method is already public in the C++ implementation. It has also now been
   added to the Javascript implementation.
Metadata changes:
 - Updated alternate formatting data for country calling code(s): 91
 - Updated phone metadata for region code(s):
   AU, AX, BY, BZ, FR, GY, IN, MC, NA, SJ, TG, TT, VN
 - Updated short number metadata for region code(s): HR, TG
 - Armenia geocoding data that is in Armenian language is moved to right language
   code (hy).
 - Updated geocoding data for country calling code(s): 91 (en), 374 (en, ru)
 - Updated carrier data for country calling code(s): 91 (en)

Jan 25, 2017: v8.1.0
Code changes:
 - Introduced new isCarrierSpecificForRegion() API in ShortNumberInfo class.
   This determines whether the provided short code is carrier-specific or
   not when dialed from the given region.
Metadata changes:
 - New alternate formatting data for country calling code(s): 52
 - Updated alternate formatting data for country calling code(s): 62
 - Updated phone metadata for region code(s):
   AR, DJ, GB, GG, GH, ID, IM, IN, JE, MA, MQ, MZ, RO, ZA
 - Updated short number metadata for region code(s): ZA
 - Updated geocoding data for country calling code(s): 27 (en)
 - Updated carrier data for country calling code(s):
   91 (en), 93 (en, fa), 233 (en), 253 (en), 258 (en)

Jan 11, 2017: v8.0.1
Metadata changes:
 - Updated phone metadata for region code(s):
   BR, CI, CL, CN, CR, DE, FR, GB, GW, HN, IL, IN, KM, KZ, NG, PG, SC, SK, SO,
   TT, UA, ZA
 - Updated short number metadata for region code(s): BH, BR, SK
 - New geocoding data for country calling code(s): 675 (en)
 - Updated geocoding data for country calling code(s):
   7 (en, ru), 86 (en, zh), 252 (en), 374 (en), 504 (en)
 - New carrier data for country calling code(s): 7 (ru), 44 (en), 269 (en)
 - Updated carrier data for country calling code(s):
   7 (en), 62 (en), 86 (en, zh, zh_Hant), 91 (en), 225 (en), 234 (en), 245 (en),
   252 (en)

Dec 07, 2016: v8.0.0
Code changes:
 - Deleted deprecated methods in ShortNumberInfo that work on strings, instead
   of phone number objects. These have been marked deprecated for months. Any
   users of these methods should call PhoneNumberUtil.parse first to create a
   PhoneNumber object, and pass this in.
 - Support semicolon as extension character while parsing phone numbers. This
   is not applicable when you are trying to find the phone numbers.
 - Updated JavaScript to throw an error rather than a string. As a result, users
   doing custom behavior depending on the value of the error must now compare
   to the value of e.message.
Metadata changes:
 - Updated phone metadata for region code(s):
   AM, BD, BR, CI, ES, IN, KI, KR, LI, MC, MM, TZ
 - Updated short number metadata for region code(s): KI, MV, MY
 - New geocoding data for country calling code(s): 227 (en), 240 (en), 255 (en)
 - Updated geocoding data for country calling code(s): 95 (en), 686 (en)
 - New carrier data for country calling code(s): 423 (en)
 - Updated carrier data for country calling code(s):
   90 (en), 91 (en), 95 (en), 255 (en), 374 (en, ru)

Nov 23, 2016: v7.7.5
Code changes:
 - Removing all references to possible_number_pattern other than the proto
   buffer itself (and derived files, or hand-crafted files based on it.) This
   information is no longer present in the binary.
 - Refactored metadata loading and removed synchronization for all kinds of
   metadata. Clients may experience quicker loading of alternate formats and
   short number metadata, but no change is required for callers of the library.
 - Reduced visibility of `public` internal API
   `PhoneNumberUtil.createInstance(MetadataSource)` to `private`. MetadataSource
   and all its implementations are non-public so this should not affect public
   usage of the library.
Metadata changes:
 - Updated phone metadata for region code(s):
   BB, BD, ES, HN, IN, KR, KW, MC, NL, PH, PK, SH, TW, VG, ZW
 - Updated short number metadata for region code(s):
   AF, AG, AM, AR, AW, AZ, BD, BM, BQ, BW, CD, CI, CM, CO, CW, DZ, GD, GE, GN,
   GT, GY, HN, HT, IE, IN, IQ, JM, JO, KE, KG, KH, KW, LV, NO, SG, SV, UY
 - Updated geocoding data for country calling code(s): 504 (en)
 - New carrier data for country calling code(s): 886 (en), 1284 (en)
 - Updated carrier data for country calling code(s): 63 (en), 92 (en)

Nov 09, 2016: v7.7.4
GitHub project changes:
 - Changed tag to vX.Y.Z from libphonenumber-X.Y.Z; this may affect ports and
   derived projects.
Metadata structure changes in XML file:
 - Mobile and Fixed-Line blocks are no longer assumed to inherit missing data
   from the GeneralDesc, but are treated like every other phone number type.
   This means that for the non-geographical country codes, like +800, the
   example number has been moved from generalDesc to the relevant number types,
   and the code in getExampleNumberForNonGeoEntity has been changed to look at
   these sub-types for an example number.
   This also means that the "NA" and "-1" blocks present in the metadata to
   indicate that no mobile or fixed-line numbers appear for the entity have been
   removed.
   There should no longer be an exampleNumber at the generalDesc level, but it
   should be present at every PhoneNumberDesc with data.
Code changes:
 - Using new possibleLengthInfo to decide whether a short number is the right
   length or not. This could result in more specific results; whereas before, a
   number from length 3 to length 6 may have been deemed possible, now we may
   exclude a number of length 5.
 - Add hash (#) as a diallable character. Numbers with # in them will no longer
   have formatting applied in formatInOriginalFormat, and
   normalizeDiallableCharsOnly now retains the # symbol.
 - getExampleNumberForNonGeoEntity has been changed to look at the specific
   number types, not just the generalDesc, for the example numbers; this is a
   necessary change after the metadata structure change detailed above.
Metadata changes:
 - Updated phone metadata for region code(s): AD, AE, IN, IR, MU, MV, NG, PG
 - Updated short number metadata for region code(s): NL, SN
 - New geocoding data for country calling code(s):
   960 (en), 1249 (en), 1343 (en), 1579 (en), 1581 (en)
 - Updated geocoding data for country calling code(s):
   1782 (en), 1867 (en), 1902 (en)
 - Updated carrier data for country calling code(s):
   91 (en), 234 (en), 971 (en)

Oct 26, 2016: libphonenumber-7.7.3
Internal changes:
 - Fixed Phonemetadata.java not to merge from a NumberFormat's unset bool
   national_prefix_optional_when_formatting.
 - Added MetadataFilter, an internal API which is under development and subject
   to backwards-incompatible changes without notice or guarantees.
Metadata changes:
 - Updated phone metadata for region code(s):
   882, AG, AI, AS, BB, BM, BR, BS, CA, DM, DO, GD, GU, HU, IN, JM, KN, KY, KZ,
   LC, MP, MS, PR, SX, TC, TR, TT, UG, US, VC, VG, VI
 - Updated short number metadata for region code(s): UY
 - New geocoding data for country calling code(s): 1463 (en), 358 (sv)
 - Removed geocoding data for country calling code(s): 358 (se)
 - Updated geocoding data for country calling code(s): 7 (en, ru)
 - Updated carrier data for country calling code(s):
   91 (en), 256 (en), 1876 (en)

Oct 06, 2016: libphonenumber-7.7.2
Code changes:
 - Stop setting empty preferred_domestic_carrier_code, and if we are passed such
   a number then treat the empty field as if unset.
Metadata changes:
 - Updated phone metadata for region code(s): CL, FR, KE, MU, NG
 - Updated short number metadata for region code(s):
   EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, OM, PA, PE, PF, PG, PH,
   PK, PL, PM, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG,
   SH, SI, SJ, SK, SL, SM, SN, SO, SR, ST, SV, SX, SY, SZ, TC, TD, TG, TH, TJ,
   TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI,
   VN, VU, WF, WS, YE, YT, ZA, ZM, ZW
 - Updated geocoding data for country calling code(s): 56 (en, es)
 - Updated carrier data for country calling code(s):
   230 (en), 234 (en), 254 (en)

Sep 27, 2016: libphonenumber-7.7.1
Build changes:
 - OSGi support added to Manifest information when building jar (#1300)
 - BuildMetadataJsonFromXml changed to output possible lengths for JS build
 - Fix geocoding file generation to handle language codes that are not just
   two letters long properly and to process filenames in the same order.
Code changes:
 - Switching the internal implementation of isPossible and related functions
   to use the new possibleLengths metadata. This affects a lot of countries,
   making isPossible more restrictive as more precise data is available. It
   also affects parsing ambiguous and invalid numbers, as we decide whether
   to strip a possible national prefix (1) or country code based on the length
   of the number and whether it is possible before or after this.
 - Formatting, naming (LOGGER -> logger) and comment tweaks to follow style
   guide
 - Removal of unneeded canBeGeocoded method in the
   PhoneNumberToTimeZonesMapper.java, using phoneNumberUtil instead
Metadata changes:
 - Updated phone metadata for region code(s):
   800, 808, 870, 878, 881, 882, 883, 888, 979, AG, AM, BD, BF, CL, CO, EC, ET,
   GB, GG, GH, IN, LR, MD, MQ, SH, SN, TA, TH, TR
 - Updated short number metadata for region code(s):
   AC, AD, AE, AF, AG, AI, AL, AM, AO, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD,
   BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BW, BY, BZ, CA, CC,
   CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ,
   DK, DM, DO, DZ, MD
 - New carrier data for country calling code(s): 593 (en)
 - Updated carrier data for country calling code(s):
   49 (en), 56 (en), 66 (en), 90 (en), 91 (en), 226 (en), 231 (en), 373 (en),
   852 (zh_Hant)

Sep 19, 2016: libphonenumber-7.7.0
Code changes:
 - Removed the dependency on protobuf (protobuf-javanano) from the Java library,
   resurrecting
   java/libphonenumber/src/com/google/i18n/phonenumbers/Phonemetadata.java
   which was present until libphonenumber-7.1.1.
   Does not affect the C++ or JavaScript libraries.

Sep 07, 2016: libphonenumber-7.6.1
Code changes:
 - Phonemetadata.java has two more fields to represent possible lengths of phone
   numbers. Changed BuildMetadataFromXml (and the resultant jar) to alter the way
   that metadata about possible-lengths information is consumed when constructing
   metadata to populate these.
   Discussion list email:
   https://groups.google.com/forum/#!topic/libphonenumber-discuss/75TOpTFVi08
Metadata changes:
 - Updated phone metadata for region code(s):
   AG, AM, AX, BY, CD, FI, IN, KR, MA, NA, NL, PK, SY
 - Updated short number metadata for region code(s): BR, GB, NL, NZ
 - New geocoding data for country calling code(s):
   82 (pl, pt, ro, ru, sl, sr, uk, vi)
 - Updated carrier data for country calling code(s):
   27 (en), 91 (en), 243 (en), 963 (en)

Aug 24, 2016: libphonenumber-7.6.0
Code changes:
 - Refactored metadata loading and closed all streams after loading.
 - Made isNumberGeographical public, and changed the geocoder to
   use this when checking whether to give a detailed answer or country-level
   only.
Build changes:
 - Use protobuf-javanano 3.0.0-alpha-7 from Maven Central.
Metadata changes:
 - Updated phone metadata for region code(s): EH, ET, JM, MA, SK, SN, SY, ZM
 - Updated short number metadata for region code(s): ZA
 - Updated geocoding data for country calling code(s): 212 (en)
 - New carrier data for country calling code(s):
   86 (zh, zh_Hant), 852 (zh, zh_Hant), 963 (en)
 - Updated carrier data for country calling code(s):
   86 (en), 212 (en), 251 (en), 421 (en)
 - Deleted unsupported SingleFilePhoneNumberMetadataProto

Aug 10, 2016: libphonenumber-7.5.2
Metadata changes:
 - Updated phone metadata for region code(s): CO, IN, ME
 - Updated short number metadata for region code(s): IN
 - New carrier data for country calling code(s): 382 (en)
 - Updated carrier data for country calling code(s): 91 (en)

Jul 27, 2016: libphonenumber-7.5.1
Metadata changes:
 - Updated alternate formatting data for country calling code(s): 595
 - Updated phone metadata for region code(s): BD, BG, CI, IN, PY, TJ
 - Updated short number metadata for region code(s): IN
 - New geocoding data for country calling code(s):
   82 (bg, ca, el, es, fi, hi, hu, iw, ja, tr)
 - Updated geocoding data for country calling code(s): 44 (en)
 - New carrier data for country calling code(s): 374 (ru)
 - Updated carrier data for country calling code(s):
   91 (en), 374 (en), 992 (en)

Jul 22, 2016: libphonenumber-7.5.0
Code changes:
 - Simplify concurrent metadata loading in MultiFileMetadataSourceImpl and
   reduce points of contention.

Jul 14, 2016: libphonenumber-7.4.5
Metadata changes:
 - Updated phone metadata for region code(s): CN, HN, IN, KW, LV, TC
 - Updated short number metadata for region code(s): AE, BR, GB, ZA
 - New geocoding data for country calling code(s): 93 (fa), 992 (en)
 - Updated geocoding data for country calling code(s):
   91 (en), 98 (en, fa), 371 (en), 504 (en), 1 (en)
 - Updated carrier data for country calling code(s): 91 (en)

Jun 29, 2016: libphonenumber-7.4.4
Metadata changes:
 - Updated phone metadata for region code(s): AZ, BH, HN, IN, US
 - Updated short number metadata for region code(s): BR, IN, SK
 - New geocoding data for country calling code(s): 994 (en),
 - Updated geocoding data for country calling code(s): 504 (en), 1 (en)
 - Updated carrier data for country calling code(s):
   91 (en), 973 (en), 994 (en)

Jun 15, 2016: libphonenumber-7.4.3
Metadata changes:
 - Updated phone metadata for region code(s):
   HK, HN, IN, KN, KW, SK, SN, TH, TZ
 - Updated short number metadata for region code(s): AR, NO
 - New geocoding data for country calling code(s): 93 (en), 504 (en)
 - New carrier data for country calling code(s): 93 (fa), 98 (fa)
 - Updated carrier data for country calling code(s):
   66 (en), 91 (en), 255 (en), 421 (en)

Jun 01, 2016: libphonenumber-7.4.2
Code changes:
 - Make C++ code forward compatible with an upcoming RE2 change.
Metadata changes:
 - Updated phone metadata for region code(s): AE, BZ, GU, IN, KR
 - Updated short number metadata for region code(s): BR
 - New geocoding data for country calling code(s): 501 (en)
 - Updated carrier data for country calling code(s):
   91 (en), 971 (en), 1671 (en)

May 18, 2016: libphonenumber-7.4.1
Metadata changes:
 - Updated phone metadata for region code(s): FR, IL, KR
 - Updated carrier data for country calling code(s): 972 (en)

May 11, 2016: libphonenumber-7.4.0
Maven changes:
 - Repackage protobuf runtime dependency to prevent conflicts with clients'
   protobuf dependencies. Backwards-compatible, so no changes needed for clients
   who could use the previous release, but enables those with their own protobuf
   dependencies to use this and future releases without workarounds.

May 03, 2016: libphonenumber-7.3.2
Metadata changes:
 - Updated phone metadata for region code(s):
   AU, BR, ET, IN, KH, ML, NO, SB, TJ, US
 - Updated short number metadata for region code(s): CA, ML, US
 - New geocoding data for country calling code(s): 223 (en)
 - Updated geocoding data for country calling code(s):
   27 (en), 55 (en, pt), 1 (en)
 - Updated carrier data for country calling code(s):
   61 (en), 91 (en), 223 (en), 251 (en), 677 (en), 992 (en)

Apr 20, 2016: libphonenumber-7.3.1
Metadata changes:
 - Updated phone metadata for region code(s): DE, DJ, IL, IN, KH
 - Updated short number metadata for region code(s): BR
 - Updated carrier data for country calling code(s):
   91 (en), 855 (en), 972 (en)

Apr 05, 2016: libphonenumber-7.3.0
Code changes:
 - Added java/pending_code_changes.txt for contributors to track code changes
   between releases.
 - Reduced minimum required version of cmake to 2.8.
 - Added cmake installation instructions for Mac.
 - Added getExampleNumberForType that doesn't take in a region, and
   getInvalidExampleNumber
 - Improvements to javadoc for parse method
 - Update isNumberGeographical to return true for geographical mobile numbers.
Metadata changes:
 - Updated phone metadata for region code(s):
   BJ, BZ, CI, ET, GQ, KE, KW, ML, NO, OM, VN
 - Updated short number metadata for region code(s): KE
 - Updated geocoding data for country calling code(s):
   84 (en), 251 (en), 254 (en)
 - Updated carrier data for country calling code(s):
   84 (en), 225 (en), 229 (en), 254 (en), 968 (en)

Mar 21, 2016: libphonenumber-7.2.8
Metadata changes:
 - Updated phone metadata for region code(s): CL, CN, FO, KE, SE, SO
 - Updated short number metadata for region code(s): FO
 - Updated geocoding data for country calling code(s): 86 (en, zh)
 - Updated carrier data for country calling code(s):
   86 (en), 252 (en), 254 (en)

Mar 09, 2016: libphonenumber-7.2.7
Code changes:
 - Update nationalPrefixOptionalWhenFormatting documentation.
Metadata changes:
 - Updated phone metadata for region code(s): CN, IN, MO, TK
 - Updated short number metadata for region code(s): FR
 - Updated carrier data for country calling code(s): 853 (en)
 - Updated / refreshed time zone meta data.

Feb 25, 2016: libphonenumber-7.2.6
Metadata changes:
 - Updated phone metadata for region code(s): DJ, MA, NA, US
 - Updated short number metadata for region code(s): KR
 - New geocoding data for country calling code(s): 1380 (en)
 - Updated geocoding data for country calling code(s): 212 (en)

Feb 10, 2016: libphonenumber-7.2.5
Code changes:
 - Fix two places in demo where NPEs can occur on bad input.
 - Fix an IllegalStateException when getMetadataForNonGeographicalRegion is
   called with a country calling code which isn't a non-geographic entity.
Metadata changes:
 - Updated phone metadata for region code(s):
   AG, AI, AS, BB, BM, BS, CA, DM, DO, ET, GD, GU, JM, KN, KY, LC, MP, MS, PR,
   SE, SK, SX, TC, TT, US, VC, VG, VI
 - Updated geocoding data for country calling code(s): 46 (en)
 - Updated carrier data for country calling code(s): 251 (en)

Jan 28, 2016: libphonenumber-7.2.4
 - First release to automatically remove obsolete geocoding files
Metadata changes:
 - Updated phone metadata for region code(s):
   BW, CA, CI, CK, GM, IN, NA, NG, PG, TD, TM
 - Updated short number metadata for region code(s): PT
 - New geocoding data for country calling code(s): 1825 (en)
 - Removed geocoding data for country calling code(s):
   1726 (en), 1730 (en), 1838 (en), 1851 (en), 1888 (en), 225 (fr), 242 (fr),
   269 (fr), 238(pt), 55 (pt)
 - Updated carrier data for country calling code(s):
   91 (en), 225 (en), 234 (en), 235 (en), 675 (en), 993 (en)

Jan 08, 2016: libphonenumber-7.2.3
Backwards-incompatible code changes:
 - Removed deprecated ShortNumberUtil.java
Other code changes:
 - Updated the demo:
   added short number support;
   added permalink;
   added direct link to file an issue
Metadata changes:
 - Updated phone metadata for region code(s):
   AU, BR, CC, CR, CW, CX, ET, HN, KR, SI, TV, WF
 - Updated short number metadata for region code(s): FR, HR, HU, IT, KR, LV, TV
 - New geocoding data for country calling code(s): 688 (en)
 - Updated carrier data for country calling code(s):
   61 (en), 251 (en), 506 (en), 599 (en)

Dec 15, 2015: libphonenumber-7.2.2
Metadata changes:
 - Updated phone metadata for region code(s):
   AT, BD, BR, CC, CX, CY, FI, ID, IS, KI, MM, TN, VC
 - Updated short number metadata for region code(s):
   AT, BG, CY, CZ, DE, DK, EE, FI, GB, GR, ID, IE, IS, LT, LU, MT, NL, PL, RO,
   SI, SK
 - New geocoding data for country calling code(s): 95 (en)
 - Updated carrier data for country calling code(s):
   216 (en), 354 (en), 357 (en), 686 (en)

Nov 11, 2015: libphonenumber-7.2.1
 - Fix to libphonenumber-7.2.0
Metadata changes: None

Nov 10, 2015: libphonenumber-7.2.0
* Broken, do not use *
Code changes:
 - Phonemetadata now generated as nanoproto
Metadata changes:
 - Updated phone metadata for region code(s):
   BI, BT, IL, MN, MO, NP, RU, SK, VG
 - Updated short number metadata for region code(s): BT, DK
 - New geocoding data for country calling code(s): 972 (en), 975 (en)
 - New carrier data for country calling code(s): 853 (en)
 - Updated carrier data for country calling code(s):
   45 (en), 257 (en), 421 (en), 964 (en), 972 (en), 975 (en), 976 (en)
 - Updated / refreshed time zone meta data.

Oct 29, 2015: libphonenumber-7.1.1
Metadata changes:
 - Updated phone metadata for region code(s):
   AT, BB, BR, GW, ID, MD, OM, SO, TT
 - Updated short number metadata for region code(s): BB, NO
 - New geocoding data for country calling code(s): 968 (en)
 - Updated geocoding data for country calling code(s): 245 (en, pt)
 - Updated carrier data for country calling code(s):
   62 (en), 245 (en), 252 (en), 373 (en), 968 (en), 1246 (en)

Oct 08, 2015: libphonenumber-7.1.0
API changes:
 - New MetadataSource implementation that reads from a single metadata file with
   all regions' phone number metadata.
Metadata changes:
 - Updated phone metadata for region code(s): BR, BS, HT, IR, KW, MC, PA, VU
 - Updated carrier data for country calling code(s):
   98 (en), 678 (en), 880 (en)

Sep 16, 2015: libphonenumber-7.0.11
Metadata changes:
 - Updated phone metadata for region code(s):
   IN, KE, LR, MM, MR, NA, NE, PT, RO, SO, TZ, US
 - New short number metadata for region code(s): CF, CG, ER, KP, NE, SO
 - Updated short number metadata for region code(s): CD, NO, PT
 - New geocoding data for country calling code(s): 1854 (en)
 - Updated geocoding data for country calling code(s): 264 (en)
 - Updated carrier data for country calling code(s):
   40 (en), 91 (en), 95 (en), 227 (en), 231 (en), 252 (en), 254 (en), 255 (en),
   509 (en)

Aug 31, 2015: libphonenumber-7.0.10
Metadata changes:
 - Updated phone metadata for region code(s):
   AU, BY, CR, DZ, EH, ES, HK, HT, IN, JO, MN, MU, ST, TD, TT, ZW
 - Updated short number metadata for region code(s): HK, KR
 - Updated geocoding data for country calling code(s): 263 (en)
 - New carrier data for country calling code(s): 509 (en), 976 (en)
 - Updated carrier data for country calling code(s):
   41 (en), 61 (en), 91 (en), 230 (en), 235 (en), 239 (en)

Aug 03, 2015: libphonenumber-7.0.9
Metadata changes:
 - Updated phone metadata for region code(s): AR, IN, MX, PL, SZ, YT, ZW
 - Updated short number metadata for region code(s): MX, ZW
 - Updated carrier data for country calling code(s): 91 (en), 263 (en)

Jul 14, 2015: libphonenumber-7.0.8
Metadata changes:
 - Updated phone metadata for region code(s):
   AC, BS, BW, CL, DE, DZ, HN, HR, IL, IN, IT, JO, KY, MA, NP, PL, SH, SL, TM,
   UA, VA
 - Updated short number metadata for region code(s): HR
 - Updated geocoding data for country calling code(s): 56 (en, es)
 - Updated carrier data for country calling code(s):
   49 (en), 212 (en), 232 (en), 267 (en), 380 (en), 385 (en), 962 (en),
   972 (en), 977 (en), 993 (en)
- Updated / refreshed time zone meta data.

Jun 24, 2015: libphonenumber-7.0.7
Metadata changes:
 - Updated phone metadata for region code(s):
   AC, BF, BG, CG, CM, FR, IL, IN, JP, KW, LB, LI, SB, SD, SH, TT
 - Updated short number metadata for region code(s): GY, SB
 - New geocoding data for country calling code(s): 592 (en)
 - Updated geocoding data for country calling code(s):
   86 (en, zh), 226 (en), 290 (en, fr)
 - New carrier data for country calling code(s): 592 (en), 689 (en)
 - Updated carrier data for country calling code(s):
   7 (en), 60 (en), 91 (en), 237 (en), 242 (en), 249 (en), 359 (en), 961 (en),
   1868 (en)
- Updated / refreshed time zone meta data.

May 29, 2015: libphonenumber-7.0.6
Metadata changes:
 - Updated phone metadata for region code(s):
   BB, BR, CR, ID, IL, JO, KW, LK, LU, MD, MM, MV, MY, PH, PK, SC, SE
 - Updated short number metadata for region code(s): BE, LK, US
 - Updated carrier data for country calling code(s):
   60 (en), 63 (en), 92 (en), 94 (en), 95 (en), 248 (en), 373 (en), 960 (en),
   972 (en), 1246 (en)

Apr 24, 2015: libphonenumber-7.0.5
* Metadata changes:
 - Updated phone metadata for region code(s):
   AF, AS, BD, BE, CA, CI, ID, IN, JM, KH, LI, LU, MU, NE, PL
 - Updated short number metadata for region code(s): BE, LI
 - Updated geocoding data for country calling code(s):
   62 (en), 86 (en, zh), 358 (en, fi, se)
 - Updated carrier data for country calling code(s):
   32 (en), 93 (en), 225 (en), 227 (en), 855 (en), 1684 (en), 1876 (en)

Mar 25, 2015: libphonenumber-7.0.4
* Metadata changes:
 - Updated phone metadata for region code(s): CA, HU, IL, JO, LU, SG, SL, US
 - Updated short number metadata for region code(s): BI
 - New geocoding data for country calling code(s):
   1220 (en), 1628 (en), 1629 (en)
 - Updated carrier data for country calling code(s):
   65 (en), 232 (en), 972 (en)

Mar 02, 2015: libphonenumber-7.0.3
* Metadata changes:
 - Updated phone metadata for region code(s):
   AR, BH, BY, CI, CN, GH, KR, KW, LU, ME, NZ, SB, WS
 - New geocoding data for country calling code(s): 64 (en)
 - Updated geocoding data for country calling code(s):
   86 (en, zh), 1418 (en), 1438 (en), 1450 (en), 1514 (en), 1819 (en)
 - Updated carrier data for country calling code(s):
   225 (en), 233 (en), 677 (en), 973 (en)

Jan 09, 2015: libphonenumber-7.0.2
* Metadata changes:
 - Updated phone metadata for region code(s):
   BD, BH, EH, GH, IN, JM, LU, MA, MY, NF, NG, PK, SB, TT, TZ
 - Updated geocoding data for country calling code(s): 91 (en), 352 (en, fr)
 - New carrier data for country calling code(s): 1876 (en)
 - Updated carrier data for country calling code(s):
   60 (en), 91 (en), 92 (en), 212 (en), 233 (en), 234 (en), 352 (en), 677 (en)

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 fo