Phonenumbers

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)

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)

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)

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)

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.

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)