Phonenumbers

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)

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)

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)

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)

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)

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)