Home | History | Annotate | Download | only in libphonenumber
      1 Nov 23, 2016: v7.7.5
      2 Code changes:
      3  - Removing all references to possible_number_pattern other than the proto
      4    buffer itself (and derived files, or hand-crafted files based on it.) This
      5    information is no longer present in the binary.
      6  - Refactored metadata loading and removed synchronization for all kinds of
      7    metadata. Clients may experience quicker loading of alternate formats and
      8    short number metadata, but no change is required for callers of the library.
      9  - Reduced visibility of `public` internal API
     10    `PhoneNumberUtil.createInstance(MetadataSource)` to `private`. MetadataSource
     11    and all its implementations are non-public so this should not affect public
     12    usage of the library.
     13 Metadata changes:
     14  - Updated phone metadata for region code(s):
     15    BB, BD, ES, HN, IN, KR, KW, MC, NL, PH, PK, SH, TW, VG, ZW
     16  - Updated short number metadata for region code(s):
     17    AF, AG, AM, AR, AW, AZ, BD, BM, BQ, BW, CD, CI, CM, CO, CW, DZ, GD, GE, GN,
     18    GT, GY, HN, HT, IE, IN, IQ, JM, JO, KE, KG, KH, KW, LV, NO, SG, SV, UY
     19  - Updated geocoding data for country calling code(s): 504 (en)
     20  - New carrier data for country calling code(s): 886 (en), 1284 (en)
     21  - Updated carrier data for country calling code(s): 63 (en), 92 (en)
     22 
     23 Nov 09, 2016: v7.7.4
     24 GitHub project changes:
     25  - Changed tag to vX.Y.Z from libphonenumber-X.Y.Z; this may affect ports and
     26    derived projects.
     27 Metadata structure changes in XML file:
     28  - Mobile and Fixed-Line blocks are no longer assumed to inherit missing data
     29    from the GeneralDesc, but are treated like every other phone number type.
     30    This means that for the non-geographical country codes, like +800, the
     31    example number has been moved from generalDesc to the relevant number types,
     32    and the code in getExampleNumberForNonGeoEntity has been changed to look at
     33    these sub-types for an example number.
     34    This also means that the "NA" and "-1" blocks present in the metadata to
     35    indicate that no mobile or fixed-line numbers appear for the entity have been
     36    removed.
     37    There should no longer be an exampleNumber at the generalDesc level, but it
     38    should be present at every PhoneNumberDesc with data.
     39 Code changes:
     40  - Using new possibleLengthInfo to decide whether a short number is the right
     41    length or not. This could result in more specific results; whereas before, a
     42    number from length 3 to length 6 may have been deemed possible, now we may
     43    exclude a number of length 5.
     44  - Add hash (#) as a diallable character. Numbers with # in them will no longer
     45    have formatting applied in formatInOriginalFormat, and
     46    normalizeDiallableCharsOnly now retains the # symbol.
     47  - getExampleNumberForNonGeoEntity has been changed to look at the specific
     48    number types, not just the generalDesc, for the example numbers; this is a
     49    necessary change after the metadata structure change detailed above.
     50 Metadata changes:
     51  - Updated phone metadata for region code(s): AD, AE, IN, IR, MU, MV, NG, PG
     52  - Updated short number metadata for region code(s): NL, SN
     53  - New geocoding data for country calling code(s):
     54    960 (en), 1249 (en), 1343 (en), 1579 (en), 1581 (en)
     55  - Updated geocoding data for country calling code(s):
     56    1782 (en), 1867 (en), 1902 (en)
     57  - Updated carrier data for country calling code(s):
     58    91 (en), 234 (en), 971 (en)
     59 
     60 Oct 26, 2016: libphonenumber-7.7.3
     61 Internal changes:
     62  - Fixed Phonemetadata.java not to merge from a NumberFormat's unset bool
     63    national_prefix_optional_when_formatting.
     64  - Added MetadataFilter, an internal API which is under development and subject
     65    to backwards-incompatible changes without notice or guarantees.
     66 Metadata changes:
     67  - Updated phone metadata for region code(s):
     68    882, AG, AI, AS, BB, BM, BR, BS, CA, DM, DO, GD, GU, HU, IN, JM, KN, KY, KZ,
     69    LC, MP, MS, PR, SX, TC, TR, TT, UG, US, VC, VG, VI
     70  - Updated short number metadata for region code(s): UY
     71  - New geocoding data for country calling code(s): 1463 (en), 358 (sv)
     72  - Removed geocoding data for country calling code(s): 358 (se)
     73  - Updated geocoding data for country calling code(s): 7 (en, ru)
     74  - Updated carrier data for country calling code(s):
     75    91 (en), 256 (en), 1876 (en)
     76 
     77 Oct 06, 2016: libphonenumber-7.7.2
     78 Code changes:
     79  - Stop setting empty preferred_domestic_carrier_code, and if we are passed such
     80    a number then treat the empty field as if unset.
     81 Metadata changes:
     82  - Updated phone metadata for region code(s): CL, FR, KE, MU, NG
     83  - Updated short number metadata for region code(s):
     84    EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, OM, PA, PE, PF, PG, PH,
     85    PK, PL, PM, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG,
     86    SH, SI, SJ, SK, SL, SM, SN, SO, SR, ST, SV, SX, SY, SZ, TC, TD, TG, TH, TJ,
     87    TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI,
     88    VN, VU, WF, WS, YE, YT, ZA, ZM, ZW
     89  - Updated geocoding data for country calling code(s): 56 (en, es)
     90  - Updated carrier data for country calling code(s):
     91    230 (en), 234 (en), 254 (en)
     92 
     93 Sep 27, 2016: libphonenumber-7.7.1
     94 Build changes:
     95  - OSGi support added to Manifest information when building jar (#1300)
     96  - BuildMetadataJsonFromXml changed to output possible lengths for JS build
     97  - Fix geocoding file generation to handle language codes that are not just
     98    two letters long properly and to process filenames in the same order.
     99 Code changes:
    100  - Switching the internal implementation of isPossible and related functions
    101    to use the new possibleLengths metadata. This affects a lot of countries,
    102    making isPossible more restrictive as more precise data is available. It
    103    also affects parsing ambiguous and invalid numbers, as we decide whether
    104    to strip a possible national prefix (1) or country code based on the length
    105    of the number and whether it is possible before or after this.
    106  - Formatting, naming (LOGGER -> logger) and comment tweaks to follow style
    107    guide
    108  - Removal of unneeded canBeGeocoded method in the
    109    PhoneNumberToTimeZonesMapper.java, using phoneNumberUtil instead
    110 Metadata changes:
    111  - Updated phone metadata for region code(s):
    112    800, 808, 870, 878, 881, 882, 883, 888, 979, AG, AM, BD, BF, CL, CO, EC, ET,
    113    GB, GG, GH, IN, LR, MD, MQ, SH, SN, TA, TH, TR
    114  - Updated short number metadata for region code(s):
    115    AC, AD, AE, AF, AG, AI, AL, AM, AO, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD,
    116    BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BW, BY, BZ, CA, CC,
    117    CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ,
    118    DK, DM, DO, DZ, MD
    119  - New carrier data for country calling code(s): 593 (en)
    120  - Updated carrier data for country calling code(s):
    121    49 (en), 56 (en), 66 (en), 90 (en), 91 (en), 226 (en), 231 (en), 373 (en),
    122    852 (zh_Hant)
    123 
    124 Sep 19, 2016: libphonenumber-7.7.0
    125 Code changes:
    126  - Removed the dependency on protobuf (protobuf-javanano) from the Java library,
    127    resurrecting
    128    java/libphonenumber/src/com/google/i18n/phonenumbers/Phonemetadata.java
    129    which was present until libphonenumber-7.1.1.
    130    Does not affect the C++ or JavaScript libraries.
    131 
    132 Sep 07, 2016: libphonenumber-7.6.1
    133 Code changes:
    134  - Phonemetadata.java has two more fields to represent possible lengths of phone
    135    numbers. Changed BuildMetadataFromXml (and the resultant jar) to alter the way
    136    that metadata about possible-lengths information is consumed when constructing
    137    metadata to populate these.
    138    Discussion list email:
    139    https://groups.google.com/forum/#!topic/libphonenumber-discuss/75TOpTFVi08
    140 Metadata changes:
    141  - Updated phone metadata for region code(s):
    142    AG, AM, AX, BY, CD, FI, IN, KR, MA, NA, NL, PK, SY
    143  - Updated short number metadata for region code(s): BR, GB, NL, NZ
    144  - New geocoding data for country calling code(s):
    145    82 (pl, pt, ro, ru, sl, sr, uk, vi)
    146  - Updated carrier data for country calling code(s):
    147    27 (en), 91 (en), 243 (en), 963 (en)
    148 
    149 Aug 24, 2016: libphonenumber-7.6.0
    150 Code changes:
    151  - Refactored metadata loading and closed all streams after loading.
    152  - Made isNumberGeographical public, and changed the geocoder to
    153    use this when checking whether to give a detailed answer or country-level
    154    only.
    155 Build changes:
    156  - Use protobuf-javanano 3.0.0-alpha-7 from Maven Central.
    157 Metadata changes:
    158  - Updated phone metadata for region code(s): EH, ET, JM, MA, SK, SN, SY, ZM
    159  - Updated short number metadata for region code(s): ZA
    160  - Updated geocoding data for country calling code(s): 212 (en)
    161  - New carrier data for country calling code(s):
    162    86 (zh, zh_Hant), 852 (zh, zh_Hant), 963 (en)
    163  - Updated carrier data for country calling code(s):
    164    86 (en), 212 (en), 251 (en), 421 (en)
    165  - Deleted unsupported SingleFilePhoneNumberMetadataProto
    166 
    167 Aug 10, 2016: libphonenumber-7.5.2
    168 Metadata changes:
    169  - Updated phone metadata for region code(s): CO, IN, ME
    170  - Updated short number metadata for region code(s): IN
    171  - New carrier data for country calling code(s): 382 (en)
    172  - Updated carrier data for country calling code(s): 91 (en)
    173 
    174 Jul 27, 2016: libphonenumber-7.5.1
    175 Metadata changes:
    176  - Updated alternate formatting data for country calling code(s): 595
    177  - Updated phone metadata for region code(s): BD, BG, CI, IN, PY, TJ
    178  - Updated short number metadata for region code(s): IN
    179  - New geocoding data for country calling code(s):
    180    82 (bg, ca, el, es, fi, hi, hu, iw, ja, tr)
    181  - Updated geocoding data for country calling code(s): 44 (en)
    182  - New carrier data for country calling code(s): 374 (ru)
    183  - Updated carrier data for country calling code(s):
    184    91 (en), 374 (en), 992 (en)
    185 
    186 Jul 22, 2016: libphonenumber-7.5.0
    187 Code changes:
    188  - Simplify concurrent metadata loading in MultiFileMetadataSourceImpl and
    189    reduce points of contention.
    190 
    191 Jul 14, 2016: libphonenumber-7.4.5
    192 Metadata changes:
    193  - Updated phone metadata for region code(s): CN, HN, IN, KW, LV, TC
    194  - Updated short number metadata for region code(s): AE, BR, GB, ZA
    195  - New geocoding data for country calling code(s): 93 (fa), 992 (en)
    196  - Updated geocoding data for country calling code(s):
    197    91 (en), 98 (en, fa), 371 (en), 504 (en), 1 (en)
    198  - Updated carrier data for country calling code(s): 91 (en)
    199 
    200 Jun 29, 2016: libphonenumber-7.4.4
    201 Metadata changes:
    202  - Updated phone metadata for region code(s): AZ, BH, HN, IN, US
    203  - Updated short number metadata for region code(s): BR, IN, SK
    204  - New geocoding data for country calling code(s): 994 (en),
    205  - Updated geocoding data for country calling code(s): 504 (en), 1 (en)
    206  - Updated carrier data for country calling code(s):
    207    91 (en), 973 (en), 994 (en)
    208 
    209 Jun 15, 2016: libphonenumber-7.4.3
    210 Metadata changes:
    211  - Updated phone metadata for region code(s):
    212    HK, HN, IN, KN, KW, SK, SN, TH, TZ
    213  - Updated short number metadata for region code(s): AR, NO
    214  - New geocoding data for country calling code(s): 93 (en), 504 (en)
    215  - New carrier data for country calling code(s): 93 (fa), 98 (fa)
    216  - Updated carrier data for country calling code(s):
    217    66 (en), 91 (en), 255 (en), 421 (en)
    218 
    219 Jun 01, 2016: libphonenumber-7.4.2
    220 Code changes:
    221  - Make C++ code forward compatible with an upcoming RE2 change.
    222 Metadata changes:
    223  - Updated phone metadata for region code(s): AE, BZ, GU, IN, KR
    224  - Updated short number metadata for region code(s): BR
    225  - New geocoding data for country calling code(s): 501 (en)
    226  - Updated carrier data for country calling code(s):
    227    91 (en), 971 (en), 1671 (en)
    228 
    229 May 18, 2016: libphonenumber-7.4.1
    230 Metadata changes:
    231  - Updated phone metadata for region code(s): FR, IL, KR
    232  - Updated carrier data for country calling code(s): 972 (en)
    233 
    234 May 11, 2016: libphonenumber-7.4.0
    235 Maven changes:
    236  - Repackage protobuf runtime dependency to prevent conflicts with clients'
    237    protobuf dependencies. Backwards-compatible, so no changes needed for clients
    238    who could use the previous release, but enables those with their own protobuf
    239    dependencies to use this and future releases without workarounds.
    240 
    241 May 03, 2016: libphonenumber-7.3.2
    242 Metadata changes:
    243  - Updated phone metadata for region code(s):
    244    AU, BR, ET, IN, KH, ML, NO, SB, TJ, US
    245  - Updated short number metadata for region code(s): CA, ML, US
    246  - New geocoding data for country calling code(s): 223 (en)
    247  - Updated geocoding data for country calling code(s):
    248    27 (en), 55 (en, pt), 1 (en)
    249  - Updated carrier data for country calling code(s):
    250    61 (en), 91 (en), 223 (en), 251 (en), 677 (en), 992 (en)
    251 
    252 Apr 20, 2016: libphonenumber-7.3.1
    253 Metadata changes:
    254  - Updated phone metadata for region code(s): DE, DJ, IL, IN, KH
    255  - Updated short number metadata for region code(s): BR
    256  - Updated carrier data for country calling code(s):
    257    91 (en), 855 (en), 972 (en)
    258 
    259 Apr 05, 2016: libphonenumber-7.3.0
    260 Code changes:
    261  - Added java/pending_code_changes.txt for contributors to track code changes
    262    between releases.
    263  - Reduced minimum required version of cmake to 2.8.
    264  - Added cmake installation instructions for Mac.
    265  - Added getExampleNumberForType that doesn't take in a region, and
    266    getInvalidExampleNumber
    267  - Improvements to javadoc for parse method
    268  - Update isNumberGeographical to return true for geographical mobile numbers.
    269 Metadata changes:
    270  - Updated phone metadata for region code(s):
    271    BJ, BZ, CI, ET, GQ, KE, KW, ML, NO, OM, VN
    272  - Updated short number metadata for region code(s): KE
    273  - Updated geocoding data for country calling code(s):
    274    84 (en), 251 (en), 254 (en)
    275  - Updated carrier data for country calling code(s):
    276    84 (en), 225 (en), 229 (en), 254 (en), 968 (en)
    277 
    278 Mar 21, 2016: libphonenumber-7.2.8
    279 Metadata changes:
    280  - Updated phone metadata for region code(s): CL, CN, FO, KE, SE, SO
    281  - Updated short number metadata for region code(s): FO
    282  - Updated geocoding data for country calling code(s): 86 (en, zh)
    283  - Updated carrier data for country calling code(s):
    284    86 (en), 252 (en), 254 (en)
    285 
    286 Mar 09, 2016: libphonenumber-7.2.7
    287 Code changes:
    288  - Update nationalPrefixOptionalWhenFormatting documentation.
    289 Metadata changes:
    290  - Updated phone metadata for region code(s): CN, IN, MO, TK
    291  - Updated short number metadata for region code(s): FR
    292  - Updated carrier data for country calling code(s): 853 (en)
    293  - Updated / refreshed time zone meta data.
    294 
    295 Feb 25, 2016: libphonenumber-7.2.6
    296 Metadata changes:
    297  - Updated phone metadata for region code(s): DJ, MA, NA, US
    298  - Updated short number metadata for region code(s): KR
    299  - New geocoding data for country calling code(s): 1380 (en)
    300  - Updated geocoding data for country calling code(s): 212 (en)
    301 
    302 Feb 10, 2016: libphonenumber-7.2.5
    303 Code changes:
    304  - Fix two places in demo where NPEs can occur on bad input.
    305  - Fix an IllegalStateException when getMetadataForNonGeographicalRegion is
    306    called with a country calling code which isn't a non-geographic entity.
    307 Metadata changes:
    308  - Updated phone metadata for region code(s):
    309    AG, AI, AS, BB, BM, BS, CA, DM, DO, ET, GD, GU, JM, KN, KY, LC, MP, MS, PR,
    310    SE, SK, SX, TC, TT, US, VC, VG, VI
    311  - Updated geocoding data for country calling code(s): 46 (en)
    312  - Updated carrier data for country calling code(s): 251 (en)
    313 
    314 Jan 28, 2016: libphonenumber-7.2.4
    315  - First release to automatically remove obsolete geocoding files
    316 Metadata changes:
    317  - Updated phone metadata for region code(s):
    318    BW, CA, CI, CK, GM, IN, NA, NG, PG, TD, TM
    319  - Updated short number metadata for region code(s): PT
    320  - New geocoding data for country calling code(s): 1825 (en)
    321  - Removed geocoding data for country calling code(s):
    322    1726 (en), 1730 (en), 1838 (en), 1851 (en), 1888 (en), 225 (fr), 242 (fr),
    323    269 (fr), 238(pt), 55 (pt)
    324  - Updated carrier data for country calling code(s):
    325    91 (en), 225 (en), 234 (en), 235 (en), 675 (en), 993 (en)
    326 
    327 Jan 08, 2016: libphonenumber-7.2.3
    328 Backwards-incompatible code changes:
    329  - Removed deprecated ShortNumberUtil.java
    330 Other code changes:
    331  - Updated the demo:
    332    added short number support;
    333    added permalink;
    334    added direct link to file an issue
    335 Metadata changes:
    336  - Updated phone metadata for region code(s):
    337    AU, BR, CC, CR, CW, CX, ET, HN, KR, SI, TV, WF
    338  - Updated short number metadata for region code(s): FR, HR, HU, IT, KR, LV, TV
    339  - New geocoding data for country calling code(s): 688 (en)
    340  - Updated carrier data for country calling code(s):
    341    61 (en), 251 (en), 506 (en), 599 (en)
    342 
    343 Dec 15, 2015: libphonenumber-7.2.2
    344 Metadata changes:
    345  - Updated phone metadata for region code(s):
    346    AT, BD, BR, CC, CX, CY, FI, ID, IS, KI, MM, TN, VC
    347  - Updated short number metadata for region code(s):
    348    AT, BG, CY, CZ, DE, DK, EE, FI, GB, GR, ID, IE, IS, LT, LU, MT, NL, PL, RO,
    349    SI, SK
    350  - New geocoding data for country calling code(s): 95 (en)
    351  - Updated carrier data for country calling code(s):
    352    216 (en), 354 (en), 357 (en), 686 (en)
    353 
    354 Nov 11, 2015: libphonenumber-7.2.1
    355  - Fix to libphonenumber-7.2.0
    356 Metadata changes: None
    357 
    358 Nov 10, 2015: libphonenumber-7.2.0
    359 * Broken, do not use *
    360 Code changes:
    361  - Phonemetadata now generated as nanoproto
    362 Metadata changes:
    363  - Updated phone metadata for region code(s):
    364    BI, BT, IL, MN, MO, NP, RU, SK, VG
    365  - Updated short number metadata for region code(s): BT, DK
    366  - New geocoding data for country calling code(s): 972 (en), 975 (en)
    367  - New carrier data for country calling code(s): 853 (en)
    368  - Updated carrier data for country calling code(s):
    369    45 (en), 257 (en), 421 (en), 964 (en), 972 (en), 975 (en), 976 (en)
    370  - Updated / refreshed time zone meta data.
    371 
    372 Oct 29, 2015: libphonenumber-7.1.1
    373 Metadata changes:
    374  - Updated phone metadata for region code(s):
    375    AT, BB, BR, GW, ID, MD, OM, SO, TT
    376  - Updated short number metadata for region code(s): BB, NO
    377  - New geocoding data for country calling code(s): 968 (en)
    378  - Updated geocoding data for country calling code(s): 245 (en, pt)
    379  - Updated carrier data for country calling code(s):
    380    62 (en), 245 (en), 252 (en), 373 (en), 968 (en), 1246 (en)
    381 
    382 Oct 08, 2015: libphonenumber-7.1.0
    383 API changes:
    384  - New MetadataSource implementation that reads from a single metadata file with
    385    all regions' phone number metadata.
    386 Metadata changes:
    387  - Updated phone metadata for region code(s): BR, BS, HT, IR, KW, MC, PA, VU
    388  - Updated carrier data for country calling code(s):
    389    98 (en), 678 (en), 880 (en)
    390 
    391 Sep 16, 2015: libphonenumber-7.0.11
    392 Metadata changes:
    393  - Updated phone metadata for region code(s):
    394    IN, KE, LR, MM, MR, NA, NE, PT, RO, SO, TZ, US
    395  - New short number metadata for region code(s): CF, CG, ER, KP, NE, SO
    396  - Updated short number metadata for region code(s): CD, NO, PT
    397  - New geocoding data for country calling code(s): 1854 (en)
    398  - Updated geocoding data for country calling code(s): 264 (en)
    399  - Updated carrier data for country calling code(s):
    400    40 (en), 91 (en), 95 (en), 227 (en), 231 (en), 252 (en), 254 (en), 255 (en),
    401    509 (en)
    402 
    403 Aug 31, 2015: libphonenumber-7.0.10
    404 Metadata changes:
    405  - Updated phone metadata for region code(s):
    406    AU, BY, CR, DZ, EH, ES, HK, HT, IN, JO, MN, MU, ST, TD, TT, ZW
    407  - Updated short number metadata for region code(s): HK, KR
    408  - Updated geocoding data for country calling code(s): 263 (en)
    409  - New carrier data for country calling code(s): 509 (en), 976 (en)
    410  - Updated carrier data for country calling code(s):
    411    41 (en), 61 (en), 91 (en), 230 (en), 235 (en), 239 (en)
    412 
    413 Aug 03, 2015: libphonenumber-7.0.9
    414 Metadata changes:
    415  - Updated phone metadata for region code(s): AR, IN, MX, PL, SZ, YT, ZW
    416  - Updated short number metadata for region code(s): MX, ZW
    417  - Updated carrier data for country calling code(s): 91 (en), 263 (en)
    418 
    419 Jul 14, 2015: libphonenumber-7.0.8
    420 Metadata changes:
    421  - Updated phone metadata for region code(s):
    422    AC, BS, BW, CL, DE, DZ, HN, HR, IL, IN, IT, JO, KY, MA, NP, PL, SH, SL, TM,
    423    UA, VA
    424  - Updated short number metadata for region code(s): HR
    425  - Updated geocoding data for country calling code(s): 56 (en, es)
    426  - Updated carrier data for country calling code(s):
    427    49 (en), 212 (en), 232 (en), 267 (en), 380 (en), 385 (en), 962 (en),
    428    972 (en), 977 (en), 993 (en)
    429 - Updated / refreshed time zone meta data.
    430 
    431 Jun 24, 2015: libphonenumber-7.0.7
    432 Metadata changes:
    433  - Updated phone metadata for region code(s):
    434    AC, BF, BG, CG, CM, FR, IL, IN, JP, KW, LB, LI, SB, SD, SH, TT
    435  - Updated short number metadata for region code(s): GY, SB
    436  - New geocoding data for country calling code(s): 592 (en)
    437  - Updated geocoding data for country calling code(s):
    438    86 (en, zh), 226 (en), 290 (en, fr)
    439  - New carrier data for country calling code(s): 592 (en), 689 (en)
    440  - Updated carrier data for country calling code(s):
    441    7 (en), 60 (en), 91 (en), 237 (en), 242 (en), 249 (en), 359 (en), 961 (en),
    442    1868 (en)
    443 - Updated / refreshed time zone meta data.
    444 
    445 May 29, 2015: libphonenumber-7.0.6
    446 Metadata changes:
    447  - Updated phone metadata for region code(s):
    448    BB, BR, CR, ID, IL, JO, KW, LK, LU, MD, MM, MV, MY, PH, PK, SC, SE
    449  - Updated short number metadata for region code(s): BE, LK, US
    450  - Updated carrier data for country calling code(s):
    451    60 (en), 63 (en), 92 (en), 94 (en), 95 (en), 248 (en), 373 (en), 960 (en),
    452    972 (en), 1246 (en)
    453 
    454 Apr 24, 2015: libphonenumber-7.0.5
    455 * Metadata changes:
    456  - Updated phone metadata for region code(s):
    457    AF, AS, BD, BE, CA, CI, ID, IN, JM, KH, LI, LU, MU, NE, PL
    458  - Updated short number metadata for region code(s): BE, LI
    459  - Updated geocoding data for country calling code(s):
    460    62 (en), 86 (en, zh), 358 (en, fi, se)
    461  - Updated carrier data for country calling code(s):
    462    32 (en), 93 (en), 225 (en), 227 (en), 855 (en), 1684 (en), 1876 (en)
    463 
    464 Mar 25, 2015: libphonenumber-7.0.4
    465 * Metadata changes:
    466  - Updated phone metadata for region code(s): CA, HU, IL, JO, LU, SG, SL, US
    467  - Updated short number metadata for region code(s): BI
    468  - New geocoding data for country calling code(s):
    469    1220 (en), 1628 (en), 1629 (en)
    470  - Updated carrier data for country calling code(s):
    471    65 (en), 232 (en), 972 (en)
    472 
    473 Mar 02, 2015: libphonenumber-7.0.3
    474 * Metadata changes:
    475  - Updated phone metadata for region code(s):
    476    AR, BH, BY, CI, CN, GH, KR, KW, LU, ME, NZ, SB, WS
    477  - New geocoding data for country calling code(s): 64 (en)
    478  - Updated geocoding data for country calling code(s):
    479    86 (en, zh), 1418 (en), 1438 (en), 1450 (en), 1514 (en), 1819 (en)
    480  - Updated carrier data for country calling code(s):
    481    225 (en), 233 (en), 677 (en), 973 (en)
    482 
    483 Jan 09, 2015: libphonenumber-7.0.2
    484 * Metadata changes:
    485  - Updated phone metadata for region code(s):
    486    BD, BH, EH, GH, IN, JM, LU, MA, MY, NF, NG, PK, SB, TT, TZ
    487  - Updated geocoding data for country calling code(s): 91 (en), 352 (en, fr)
    488  - New carrier data for country calling code(s): 1876 (en)
    489  - Updated carrier data for country calling code(s):
    490    60 (en), 91 (en), 92 (en), 212 (en), 233 (en), 234 (en), 352 (en), 677 (en)
    491 
    492 Nov 25, 2014: libphonenumber-7.0.1
    493 * Metadata changes:
    494  - New alternate formatting data for country calling code(s): 676
    495  - Updated phone metadata for region code(s):
    496    BI, CM, ID, IR, KR, LA, NP, TG, TH, TO
    497  - New geocoding data for country calling code(s): 237 (en)
    498  - Updated geocoding data for country calling code(s): 98 (en, fa)
    499  - Updated carrier data for country calling code(s):
    500    237 (en), 257 (en), 856 (en), 977 (en)
    501 
    502 Oct 29, 2014: libphonenumber-7.0
    503 * Code changes:
    504  - New APIs for ShortNumberInfo. The old APIs have been deprecated and will be
    505    removed in an upcoming release.
    506 * Metadata changes:
    507  - Updated phone metadata for region code(s):
    508    AR, AU, CC, CI, CX, DZ, EE, IN, KZ, MC, SB, TJ, TT
    509  - Updated short number metadata for region code(s): MC
    510  - Updated geocoding data for country calling code(s): 34 (en, es), 54 (en)
    511  - Updated carrier data for country calling code(s):
    512    7 (en), 61 (en), 91 (en), 225 (en), 677 (en), 967 (en), 992 (en), 1868 (en)
    513 
    514 Oct 13, 2014: libphonenumber-6.3.1
    515 * Metadata changes:
    516  - Updated phone metadata for region code(s):
    517    AC, AU, CR, DE, IL, MR, NO, SA, SR, UG
    518  - Updated short number metadata for region code(s): CR
    519  - Updated carrier data for country calling code(s):
    520    61 (en), 256 (en), 506 (en), 597 (en), 966 (en), 972 (en)
    521 
    522 Sep 25, 2014: libphonenumber-6.3
    523 * Code changes:
    524   - Changing the offline geocoder to not return any country at all if the number
    525     could belong to multiple countries
    526   - Removing obsolete code that treated countries with no metadata as valid.
    527 * Metadata changes:
    528  - New alternate formatting data for country calling code(s): 54, 91
    529  - Updated phone metadata for region code(s):
    530    AM, AR, BR, CA, CL, IL, IN, IR, IS, KE, NI, PF, SB, SN, TH, TN, US
    531  - New geocoding data for country calling code(s):
    532    1782 (en), 1929 (en), 1930 (en), 1938 (en)
    533  - Updated geocoding data for country calling code(s): 98 (en, fa)
    534  - New carrier data for country calling code(s): 354 (en)
    535  - Updated carrier data for country calling code(s):
    536    27 (en), 56 (en), 66 (en), 91 (en), 92 (en), 98 (en), 216 (en), 221 (en),
    537    254 (en), 374 (en), 505 (en), 677 (en), 972 (en)
    538 
    539 Aug 21, 2014: libphonenumber-6.2.2
    540 * Metadata changes:
    541  - Updated phone metadata for region code(s): BN, CL, CO, DK, IN, SB, SO
    542  - Updated short number metadata for region code(s): FR, SA, US
    543  - Updated carrier data for country calling code(s):
    544    27 (en), 57 (en), 91 (en), 252 (en), 677 (en)
    545 
    546 Jul 28, 2014: libphonenumber-6.2.1
    547 * Metadata changes:
    548  - Updated phone metadata for region code(s): BW, LB, MD, PA, PF, VI, ZM
    549  - New carrier data for country calling code(s): 507 (en), 961 (en)
    550  - Updated carrier data for country calling code(s): 267 (en), 373 (en)
    551 
    552 Jun 30, 2014: libphonenumber-6.2
    553 * Code changes:
    554  - Better exclusion of dates when matching phone numbers from text.
    555  - Handle phone input in RFC3966 with missing tel: prefix
    556 
    557 * Metadata changes:
    558  - New alternate formatting data for country calling code(s): 95
    559  - Updated phone metadata for region code(s):
    560    AF, CN, EH, FJ, IN, JP, KE, KG, KW, MA, MM, PG, PK, SN, SO
    561  - New short number metadata for region code(s): SN
    562  - Updated short number metadata for region code(s): FR, KE
    563  - Updated geocoding data for country calling code(s): 254 (en)
    564  - New carrier data for country calling code(s): 95 (en)
    565  - Updated carrier data for country calling code(s):
    566    92 (en), 93 (en), 212 (en), 221 (en), 254 (en), 675 (en), 679 (en), 965 (en),
    567    996 (en)
    568 
    569 Jun 06, 2014: libphonenumber-6.1.1
    570 * Metadata changes:
    571  - Updated phone metadata for region code(s):
    572    AF, AG, AI, AS, BB, BF, BM, BS, CA, CN, CR, DM, DO, DZ, FR, GD, GU, IN, JM,
    573    KH, KN, KW, KY, LC, MN, MP, MS, NG, NI, PH, PR, SX, TC, TT, US, VC, VG, VI
    574  - Updated short number metadata for region code(s): AL
    575  - New geocoding data for country calling code(s): 1346 (en), 1959 (en)
    576  - Updated geocoding data for country calling code(s):
    577    33 (en, fr), 352 (de, en, fr), 355 (en)
    578  - New carrier data for country calling code(s): 505 (en)
    579  - Updated carrier data for country calling code(s):
    580    63 (en), 91 (en), 93 (en), 234 (en)
    581 
    582 May 08, 2014: libphonenumber-6.1
    583 * Code changes:
    584  - Adding MetadataLoader support to allow custom metadata loading from
    585    alternative sources (should have no visible impact to users).
    586  - Fixing bug where digits could be lost in as-you-type formatting and
    587    formatting patterns incorrectly applied.
    588 
    589 * Metadata changes:
    590  - Updated phone metadata for region code(s):
    591    AR, BF, BR, BS, CL, CN, CO, CR, DE, DM, EC, EG, FR, GA, GD, GH, HU, ID, IL,
    592    IN, JP, KH, KI, KN, LA, LC, LR, ML, MU, MX, MZ, NA, NE, PF, PL, RU, SM, TH,
    593    TW, UZ, VA, VC
    594  - Updated short number metadata for region code(s): BI, CR, PL, TH
    595  - New geocoding data for country calling code(s): 32 (de), 1242 (en)
    596  - Updated geocoding data for country calling code(s):
    597    32 (en, nl), 55 (en), 56 (en, es), 86 (en, zh)
    598  - New carrier data for country calling code(s):
    599    1758 (en), 1784 (en), 1869 (en)
    600  - Updated carrier data for country calling code(s):
    601    66 (en), 86 (en), 227 (en), 231 (en), 233 (en), 258 (en), 1473 (en),
    602    1767 (en)
    603 
    604 Feb 25, 2014: libphonenumber-6.0
    605 * Code changes:
    606  - Better support for detecting phone numbers in text that are beside each other
    607  - Change to how Japanese numbers beginning with "00" are modelled, with the
    608    side-effect that the maximum possible number length has been extended by 1.
    609  - Handle StringIndexOutOfBoundsException in the AsYouTypeFormatter when the
    610    national prefix that was extracted was not found in the prefix. This affected
    611    countries with very long carrier codes, such as Korea.
    612  - Removal of some of the author attributions - contributions to be tracked in
    613    CONTRIBUTORS file.
    614 * Metadata changes:
    615  - Updated phone metadata for region code(s): AS, BR, KW, LU
    616  - New carrier data for country calling code(s): 1684 (en)
    617  - Updated carrier data for country calling code(s): 352 (en)
    618 
    619 Feb 07, 2014: libphonenumber-5.9.4
    620 * Metadata changes:
    621  - Updated phone metadata for region code(s):
    622    883, BF, BJ, BW, CL, CR, DZ, FR, GD, IN, JP, MD, NG, NZ, PK, PL, SY, UY, VU
    623  - Updated short number metadata for region code(s): LV, MD
    624  - New carrier data for country calling code(s): 373 (en), 1473 (en)
    625  - Updated carrier data for country calling code(s):
    626    48 (en), 49 (en), 91 (en), 92 (en), 213 (en), 226 (en), 229 (en), 234 (en),
    627    267 (en), 389 (en), 506 (en), 598 (en)
    628 
    629 Jan 21, 2014: libphonenumber-5.9.3
    630 * Metadata changes:
    631  - Updated phone metadata for region code(s):
    632    BF, BH, BR, CN, GR, IN, MY, PA, TN, US
    633  - Updated short number metadata for region code(s): CN
    634  - New geocoding data for country calling code(s): 1364 (en), 1725 (en)
    635  - Updated geocoding data for country calling code(s): 86 (en)
    636  - Updated carrier data for country calling code(s):
    637    55 (en), 226 (en), 973 (en)
    638 
    639 Dec 20, 2013: libphonenumber-5.9.2
    640 * Metadata changes:
    641  - New alternate formatting data for country calling code(s): 255, 27, 381, 506
    642  - Updated alternate formatting data for country calling code(s): 43
    643  - Updated phone metadata for region code(s):
    644    AG, AI, AS, BB, BF, BM, BS, CA, CR, DM, DO, EC, GD, GU, JM, KN, KY, LC, MP,
    645    MS, PR, SO, SX, TC, TT, US, VC, VG, VI
    646  - Updated carrier data for country calling code(s): 226 (en)
    647 
    648 Dec 13, 2013: libphonenumber-5.9.1
    649 * Metadata changes:
    650  - New alternate formatting data for country calling code(s): 505, 679
    651  - Updated phone metadata for region code(s):
    652    BF, CI, EG, EH, FJ, IN, KI, MA, MT, NG, NI, SI, SN, SR, TT
    653  - Updated short number metadata for region code(s): KI
    654  - Updated geocoding data for country calling code(s):
    655    27 (en), 226 (en), 1 (en)
    656  - New carrier data for country calling code(s): 356 (en), 677 (en)
    657  - Updated carrier data for country calling code(s):
    658    212 (en), 221 (en), 225 (en), 226 (en), 234 (en), 597 (en), 1 (en)
    659 
    660 Nov 12, 2013: libphonenumber-5.9
    661 * Code changes:
    662  - Adding support for numbers with multiple Italian leading zeros, by adding a field
    663    to the phone number proto to allow an arbitrary number of leading zeros, and
    664    supporting this when parsing, validating and formatting.
    665  - Adding more functionality to ShortNumberInfo -> such as getExpectedCostForRegion.
    666  - Fix for parsing short numbers that start with the national prefix.
    667  - Updating formatNumberForMobileDialing to work with short numbers.
    668  - Stop finding Israeli 4-digit "star" numbers in text when no star is in fact present.
    669  - Bug fix for finding phone numbers where the area code was also part of the country
    670    calling code.
    671 
    672 * Metadata changes:
    673  - Updated phone metadata for region code(s):
    674    AU, BQ, BY, CI, CO, CW, GN, HN, IN, JO, KI, KW, MG, MK, MM, NA, PK, TC, TM,
    675    UG
    676  - New short number metadata for region code(s): CD, GN
    677  - Updated short number metadata for region code(s):
    678    AF, AG, AI, AM, AR, AS, AW, AZ, BD, BH, BI, BM, BO, BQ, BT, BW, BY, CA, CH,
    679    CI, CM, CO, CW, DZ, FJ, GD, GE, GH, GT, GY, HN, HT, ID, IE, IM, IN, IQ, JM,
    680    JO, KE, KG, KH, KI, KW, KZ, LR, SV
    681  - New geocoding data for country calling code(s):
    682    257 (en), 389 (en), 599 (en), 686 (en), 962 (en)
    683  - Updated geocoding data for country calling code(s):
    684    264 (en), 375 (be, en, ru)
    685  - New carrier data for country calling code(s):
    686    375 (be, ru), 389 (en), 599 (en), 965 (ar)
    687  - Updated carrier data for country calling code(s):
    688    57 (en), 61 (en), 92 (en), 225 (en), 256 (en), 257 (en), 261 (en), 375 (en),
    689    686 (en), 962 (en), 965 (en)
    690 
    691 Oct 10, 2013: libphonenumber-5.8.8
    692 * Metadata changes:
    693  - New alternate formatting data for country calling code(s):
    694    350, 358, 36, 66, 84, 94, 995
    695  - Updated alternate formatting data for country calling code(s):
    696    31, 359, 372, 49, 62, 7
    697  - Updated phone metadata for region code(s):
    698    AR, BD, BE, BF, BR, CO, CR, FI, GI, GM, IS, MU
    699  - Updated short number metadata for region code(s): AR, BE, ES, GI, PG, US
    700  - Updated geocoding data for country calling code(s): 220 (en)
    701  - Updated carrier data for country calling code(s):
    702    20 (en), 220 (en), 224 (en), 230 (en), 852 (en)
    703 
    704 Oct 8, 2013: libphonenumber-5.8.7
    705 * Code changes:
    706   - New method in the PhoneNumberUtil API - isMobileNumberPortableRegion.
    707   - Carrier mapper: Updated API and added a getSafeDisplayName method that only returns the carrier
    708                     if it's safe to display to the user.
    709 
    710 Oct 7, 2013:
    711 * Code changes:
    712   - Added PhoneNumberToTimeZonesMapper including unittests to the geocoder maven project.
    713   - Added build rules for generating the binary time zones mapping file from the text file.
    714   - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate time zone mapping.
    715 * Metadata changes:
    716   - Added the time zone mapping file.
    717 
    718 Sep 30, 2013:
    719 * Code changes:
    720   - Added PhoneNumberToCarrierMapper including unittests.
    721   - Added build rules for generating binary carrier mapping files from text files.
    722   - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate carrier mapping.
    723 * Metadata changes:
    724   - Added carrier mapping files for some NANPA countries, EG, SS, MA, DZ, TN, GM, SN, MR, ML, GN,
    725     CI, BF, NE, TG, BJ, MU, LR, SL, GH, NG, TD, CF, CM, CV, ST, GQ, GA, CG, CD, AO, GW, SC, SD, RW,
    726     ET, SO, DJ, KE, TZ, UG, BI, MZ, ZM, MG, ZW, MW, BW, SZ, ZA, AW, FO, GL, GR, NL, BE, FR, GI, PT,
    727     LU, IE, AL, CY, FI, BG, HU, LT, EE, AM, BY, AD, UA, RS, HR, SI, BA, IT, RO, CH, CZ, SK, AT, DK,
    728     NO, PL, DE, BZ, CR, PE, CU, AR, BR, CL, CO, VE, BO, PY, SR, UY, MY, AU, ID, PH, NZ, SG, TH, TL,
    729     BN, PG, TO, VU, FJ, WS, KI, RU, VN, HK, KH, LA, CN, BD, TR, IN, PK, AF, LK, MV, JO, IQ, KW, SA,
    730     YE, OM, PS, AE, IL, BH, QA, BT, NP, IR, TJ, TM, AZ, GE, KG and UZ in English.
    731 
    732 Sep 23, 2013: libphonenumber-5.8.6
    733 * Code changes:
    734   - Restructured the geocoder binary generation code, moving the classes under tools/ from
    735     geocoding/ to buildtools/ and renaming AreaCode to PhonePrefix.
    736 
    737 Sep 23, 2013: libphonenumber-5.8.5
    738 * Code changes:
    739   - Restructured the geocoder, moving the utility classes to a new module internal/prefixmapper.
    740 
    741 Sep 20, 2013: libphonenumber-5.8.4
    742 * Metadata changes:
    743  - Adding a token to indicate which countries have mobile portability.
    744 
    745 Sep 20, 2013: libphonenumber-5.8.3
    746 * Code changes:
    747   - PhoneNumberOfflineGeocoder: Moved utility functionality to PrefixFileReader.
    748   - Bug fix: Argentinian (and other countries with mobile tokens) mobile numbers now geocode
    749              correctly.
    750 
    751 Sep 19, 2013: libphonenumber-5.8.2
    752 * Code changes:
    753   - New method in the PhoneNumberUtil API - getCountryMobileToken.
    754 
    755 Sep 19, 2013: libphonenumber-5.8.1
    756 * Metadata changes:
    757  - New alternate formatting data for country calling code(s): 675
    758  - Updated phone metadata for region code(s):
    759    AO, AU, BF, BW, CA, CH, CI, CN, DE, FR, MA, MR, MU, NI, PG, SA, SE, US, VI
    760  - New short number metadata for region code(s): IQ
    761  - Updated short number metadata for region code(s):
    762    AU, BR, DO, EG, FR, GH, ID, IL, JM, KE, KZ, LR, MW, NG, NI, SA, SE, SL, TZ, US, UZ
    763  - New geocoding data for country calling code(s):
    764    966 (ar, en), 1 (en)
    765 
    766 Sep 2, 2013: libphonenumber-5.8
    767 * Code changes:
    768  - Renamed ShortNumberUtil to ShortNumberInfo -> the former class is now deprecated and will be
    769    deleted in a later release. At the moment it just delegates to ShortNumberInfo.
    770  - New methods in the ShortNumberInfo API - isCarrierSpecific, singleton interface,
    771    isPossibleShortNumber, isValidShortNumber, getShortNumberCost. Note this is an experimental API
    772    at the moment and subject to change.
    773  - Bug fixes:
    774     -- AsYouTypeFormatting: 3-digit numbers can be formatted as a group where appropriate
    775     -- AsYouTypeFormatting: Countries with an optional national prefix were considered before to
    776        have always entered it, resulting in bugs where numbers without the national prefix were
    777        not properly formatted.
    778     -- Numbers in Chile that overlap with emergency numbers are no longer marked as connecting to
    779        them
    780     -- Not requiring the NDC to be alone for countries where there is no national prefix in strict
    781        grouping when extracting phone numbers
    782 * Metadata changes:
    783  - New alternate formatting data for country calling code(s):
    784    30, 31, 385, 58, 62, 63, 971, 972
    785  - Updated alternate formatting data for country calling code(s): 43, 44, 49
    786  - Moved emergency phone number data to the ShortNumberMetadata.xml file
    787  - Updated phone metadata for region code(s):
    788    AT, EG, ML, NC, NL, SA
    789  - New short number metadata for region code(s):
    790    AR, CL, CO, ES, MX, NC
    791  - Emergency metadata fixes for region code(s):
    792    GA, JM, MH, VE
    793 
    794 Aug 09, 2013: libphonenumber-5.7.2
    795 * Metadata changes:
    796  - New alternate formatting data for country calling code(s):
    797    352, 359, 372, 373, 375, 595, 7, 855
    798  - Updated phone metadata for region code(s):
    799    AR, BF, BH, BR, BY, CH, CM, CN, GE, GW, HN, JM, KH, LT, LU, MU, NP, RO, SO
    800  - New short number metadata for region code(s): BR
    801  - Updated short number metadata for region code(s):
    802    CH, FJ, GB, GG, IM, IT, JE, SH
    803 
    804 Aug 8, 2013: libphonenumber-5.7.1
    805 * Metadata/code changes:
    806  - Change to the way the metadata is built; now only parts of the proto that are relevant will be
    807    generated. This means short-code data won't be generated for the normal protos, and fixed-line
    808    data won't be generated for short-number protos. This cuts the metadata binary size approximately
    809    in half.
    810 
    811 Jul 17, 2013: libphonenumber-5.7
    812 * Code changes:
    813  - Improve phone number extraction recall.
    814  - Add support for loading short number metadata.
    815 
    816 Jul 16, 2013: libphonenumber-5.6.2
    817 * Metadata changes:
    818  - Updated alternate formatting data for country calling code(s): 49, 61
    819  - New metadata for region code(s): TA
    820  - Updated metadata for region code(s):
    821    BF, BH, BI, BJ, BR, CR, EH, GA, GE, GN, GU, IL, IN, IR, KH, KW, KZ, MA, MT,
    822    NA, NE, NL, PH, RO, SH, SO, TK
    823  - New geocoding data for country calling code(s): 47 (en), 82 (ar)
    824  - Updated geocoding data for country calling code(s):
    825    49 (en), 98 (en, fa), 241 (en)
    826 
    827 Jul 12, 2013: libphonenumber-5.6.1
    828 * Code changes:
    829  - Rename all instances of PhoneNumberMetadata to PhoneNumberMetadata for consistency.
    830 
    831 Jun 05, 2013: libphonenumber-5.6
    832 * Code changes:
    833  - Fix for as-you-type-formatting bug affecting countries with no national prefix
    834    formatting rule, such as China.
    835 * Metadata changes:
    836  - New alternate formatting data for country calling code(s): 351
    837  - Updated alternate formatting data for country calling code(s): 49
    838  - Updated metadata for region code(s):
    839    AS, BG, BH, BJ, BL, CD, CI, DE, DZ, EH, FJ, GF, GP, IN, KH, KZ, MA, MD, MF,
    840    ML, MY, NG, PT, PY, TC, TJ, TT
    841 
    842 May 08, 2013: libphonenumber-5.5
    843 * Code changes:
    844  - Changed internal initialization code and made more fields final.
    845    Note that we now throw an exception if an attempt is made to set the
    846    metadata more than once (which should only happen during testing).
    847  - Fix problem with formatNumberForMobileDialing for HU and CL.
    848 * Metadata changes:
    849  - Updated alternate formatting data for country calling code(s): 49
    850  - Updated metadata for region code(s):
    851    AM, BF, BR, CR, DE, MA, MG, MM, SA, TL, UA
    852  - Updated geocoding data for country calling code(s): 374 (am, en, ru)
    853 
    854 Apr 19, 2013: libphonenumber-5.4.2
    855 * Metadata changes:
    856  - Updated metadata for region code(s): BF, GA, IN, KR, MV, PH, SO, UA, US
    857 
    858 Mar 25, 2013: libphonenumber-5.4.1
    859 * Metadata changes:
    860  - Updated metadata for region code(s): BF, BH, CR, EC, IR, MG, PF, TD, TN
    861  - New geocoding data for country calling code(s): 374 (am, ru)
    862  - Updated geocoding data for country calling code(s):
    863    98 (en, fa), 358 (en, se), 374 (en)
    864 
    865 Mar 07, 2013: libphonenumber-5.4
    866 * Code changes:
    867  - Switch formatNumberForMobileDialing to prefer national format to international format when the
    868    number is dialed from the same region the phone number is from.
    869 
    870 * Metadata changes:
    871  - Updated metadata for region code(s):
    872    BF, CD, CN, CZ, GN, IR, JP, KR, KW, LR, NZ, TT, UG, ZW
    873  - New geocoding data for country calling code(s): 82 (cs)
    874  - Updated geocoding data for country calling code(s):
    875    82 (en, fr, ko, zh, zh_Hant), 98 (en, fa), 263 (en)
    876 
    877 Feb 11, 2013: libphonenumber-5.3.2
    878 * Metadata changes:
    879  - Updated metadata for region code(s):
    880    BD, BE, BY, CA, EH, GR, IE, IN, IS, LI, MA, MU, PT, SE, SG, TL
    881  - New geocoding data for country calling code(s):
    882    375 (be, en, ru), 1 (en)
    883 
    884 Jan 25, 2013: libphonenumber-5.3.1
    885 * Metadata changes:
    886  - Updated metadata for region code(s): CN, DK, EH, GN, KH, KW, MA, MY, PA
    887 
    888 Jan 08, 2013: libphonenumber-5.3
    889 * Code changes:
    890  - Handling UAN numbers in Argentina better when dialling them locally from a
    891    mobile
    892 * Metadata changes:
    893  - Updated metadata for region code(s):
    894    BE, BW, CL, CN, CO, EH, KW, MA, ML, NG, PL, SY, ZA, ZM
    895  - New geocoding data for country calling code(s): 32 (en, fr, nl)
    896  - Updated geocoding data for country calling code(s): 27 (en), 86 (en, zh)
    897 
    898 Dec 06, 2012: libphonenumber-5.2.2
    899 * Metadata changes:
    900  - New metadata for region code(s): EH
    901  - Updated metadata for region code(s): BR, CL, CR, IN, MA, PG, PK, RO
    902  - New geocoding data for country calling code(s): 241 (en)
    903 
    904 Nov 26, 2012: libphonenumber-5.2.1
    905 * Metadata changes:
    906  - Updated metadata for region code(s):
    907    AE, AW, BF, CN, DE, JO, KE, KH, LT, MM, MU, NG, RW, SR, TR, VU
    908  - New geocoding data for country calling code(s): 359 (bg, en)
    909 
    910 Oct 10, 2012: libphonenumber-5.2
    911 * Code changes:
    912  - Adds isNumberGeographical() method.
    913  - Adds getRegionCodesForCountryCode() method.
    914  - Fixing issue with getSupportedGlobalNetworkCallingCodes()
    915    [https://github.com/googlei18n/libphonenumber/issues/202]
    916  - Ensures that returned collections are unmodifiable where necessary
    917    [there is a very slight risk that this may break existing users who were relying on being able
    918    to modify these collections, but doing so would be breaking lots of other assumptions that this
    919    library makes - if you need to modify any affected collections you must copy them first]
    920 * Metadata changes:
    921  - Updated metadata for region code(s): DE, GR, HR, OM, SB, ZA
    922  - Removed metadata for region code: AN (Netherlands Antilles)
    923  - Updated geocoding data for country calling code(s): 30 (el, en)
    924 
    925 Sep 27, 2012: libphonenumber-5.1.4
    926 * Metadata changes:
    927  - Updated metadata for region code(s): AU, EC, KH, LB, TN, US
    928 
    929 Sep 17, 2012: libphonenumber-5.1.3
    930 * Metadata changes:
    931  - Updated metadata for region code(s): EG, LA, LB, LI, PY
    932  - Updated metadata for non-geographical calling codes: 800, 808, 888, 979
    933  - Updated geocoding data for country calling code(s): 98 (en), 1 (en)
    934 
    935 Sep 11, 2010: libphonenumber-5.1.2
    936 * Bug fix:
    937  - Fixing regression in AsYouTypeFormatter where it no longer worked for numbers entered in national
    938    format for countries with no national prefix, e.g. Spain.
    939 
    940 Sep 5, 2010: libphonenumber-5.1.1
    941 * Code changes:
    942   - Added better logging/exception handling for catching cases where metadata is invalid/missing.
    943 
    944 Sep 3, 2012: libphonenumber-5.1
    945 * Code changes:
    946  - Inserting a space after the national prefix in the AsYouTypeFormatter when formatting numbers in
    947    national format, if the formatting rules for that country dictate that a space is appropriate.
    948  - Format emergency numbers and short-codes as a block in the AsYouTypeFormatter.
    949 * Metadata changes:
    950  - Updated metadata for region code(s): BF, BG, DZ, GA, IT, JP, KW, PF
    951 
    952 Aug 20, 2012: libphonenumber-5.0.3
    953 * Metadata changes:
    954  - New alternate formatting data for country calling code(s): 43
    955  - Updated metadata for region code(s): AT, BF, JO, NG, RU, SL
    956  - New geocoding data for country calling code(s): 62 (en, id), 98 (fa)
    957 
    958 Aug 07, 2012: libphonenumber-5.0.2
    959 * Metadata changes:
    960  - Updated metadata for region code(s):
    961    BF, CN, DJ, IL, JO, KH, KZ, MA, MT, MV, MY, NC, NG, SD, SK, SN, TL, UZ
    962  - New geocoding data for country calling code(s): 7 (ru), 98 (en)
    963  - Updated geocoding data for country calling code(s): 7 (en)
    964 
    965 July 26th, 2012: libphonenumber-5.0.1
    966 * Metadata changes
    967  - CL, DE ,IN, KR, US
    968  - New geocoding data for country calling codes 40, 57, 66, 82, 91.
    969  - Fixed comments for 353 (IE).
    970 
    971 July 12th, 2012: libphonenumber-5.0
    972 * Code changes:
    973  - Support for alternate formats when finding phone numbers.
    974  - Allowing two-digit numbers to be parsed if they are entered in national-format with no
    975    punctuation
    976 * Metadata changes
    977  - IL, GA
    978 * Other
    979  - Reflowed this file to 100 char width to make it unambiguous as to what the standard should be.
    980 
    981 July 6th, 2012: libphonenumber-4.9.1
    982 * Metadata changes
    983  - AR, BA, BF, CR, DE, EC, ES, KZ, MK, NC, NG, PF, SB, UZ, non-geo entity 882
    984  - Geocoding data updates for country calling codes 54 (AR) and 81 (JP), new data for 234 (NG)
    985 
    986 June 21st, 2012: libphonenumber-4.9
    987 * Bug fix
    988  - formatInOriginalFormat fixed not to add a star sign if it was not present originally.
    989 * Metadata changes
    990  - BF, CZ, ES, KW
    991  - Non-geographical entities with calling code 882 (BebbiCell, Maritime Communications, Oration
    992    Technologies, Telespazio and Thuraya)
    993  - Geocoding data updates for country calling codes 221, 224, 226, 242, 244, 245
    994 * Functionality changes:
    995  - Minimum allowed length for a national significant number (NSN) when parsing changed from 3 to 2.
    996  - Support parsing of RFC3966-formatted strings with an isdn-subaddress or extra parameters
    997    specified.
    998  - Allow soft hyphen to appear in phone numbers (\u00AD)
    999 * Testing changes:
   1000  - Add extra unit tests for non-geographical phone number entities
   1001  - ExampleNumbersTest testEmergency tests now uses ShortNumberUtil
   1002 
   1003 June 14th, 2012: libphonenumber-4.8.5
   1004 * Metadata update only:
   1005  - AC, CR, DE, DK, IL, IN, IS, KH, LI, LR, MA, MD, MK, PA, SA, SG, SS
   1006 
   1007 June 6th, 2012: libphonenumber-4.8.4
   1008 * Metadata update only:
   1009  - AE, RO
   1010  - Non-geographical entity with calling code 881 (Iridium)
   1011 
   1012 May 30th, 2012: libphonenumber-4.8.3
   1013 * Metadata update only:
   1014  - AN, ET, KW, MN, SX, TC, TL
   1015 
   1016 May 16th, 2012: libphonenumber-4.8.2
   1017 * Metadata update only:
   1018  - BH, CR, EE, JO, KW, LA, QA, SI, TH
   1019  - Non-geographical entity with calling code 878 (VISIONng)
   1020 
   1021 May 8th, 2012: libphonenumber-4.8.1
   1022 * Metadata update only:
   1023  - CA, CI, EG, HK, IN, IR, LB, MA, ME, MM
   1024  - Non-geographical entity with calling code 870 (Inmarsat)
   1025  - Geocoding updates for country calling codes 1 for new area codes
   1026 
   1027 April 24th, 2012: libphonenumber-4.8
   1028 * Functionality changes
   1029  - RFC format now outputs a number starting with "tel:"
   1030  - Parsing support for numbers in RFC format that contain the country info in the "phone-context"
   1031    part
   1032  - Support for obtaining area codes for Italy, Vatican City, San Marino
   1033 * Metadata changes
   1034  - AM, AO, AR, BE, BF, CD, EG, GH, GM, GN, IN, IR, IT, JO, LA, LC, MD, MS, NO, PA, PK, SI, SJ, SO,
   1035    SY, TC, TN, UZ, VN, ZW
   1036  - Geocoding updates for country calling codes 1, 20, 233, 31, 33, 352, 374, 54, 56, 86
   1037 * Refactoring of matching functions, including moving them to PhoneNumberMatcher.
   1038 
   1039 March 16th, 2012: libphonenumber-4.7
   1040 * Bug fixes
   1041  - Now return "too long" for input that is longer than 250 chars when parsing
   1042 * Metadata changes
   1043  - 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,
   1044    MK,NA,NE,NZ,SA,SB,SC,SE,SL,SN,UZ
   1045 * Refactoring of test classes so that tests requiring the test metadata to be loaded have a common
   1046   base class which handles this.
   1047 
   1048 February 9th, 2012: libphonenumber-4.6
   1049 * Bug fixes
   1050  - Fix for formatByPattern to enable RFC formatting to work
   1051  - Fix for RFC formatting to work even when the international formatting rule starts with
   1052    punctuation
   1053  - Logging consistency changes - some warnings are no longer printed, others have become only
   1054    WARNINGS
   1055  - Fix for isValidNumberForRegion potentially throwing a NPE
   1056  - Parsing Israeli * numbers written in international format now works
   1057  - PhoneNumberMatcher doesn't match timestamps as phone-numbers
   1058 * Metadata changes
   1059  - Updates for AN, AX, BF, BJ, BR, BS, DJ, FI, IN, LV, MW, RS, SC, VN
   1060  - New countries supported: SS (South Sudan), CW (Curaao) and BQ (Bonaire, Sint Eustatius and Saba)
   1061 * Refactoring of the private formatting functions in PhoneNumberUtil to ensure names are more
   1062   descriptive and to reduce code duplication.
   1063 
   1064 January 19th, 2012: libphonenumber-4.5
   1065 * Code changes
   1066  - Support for non-geographical country calling codes (e.g. +800).
   1067  - Modify formatInOriginalFormat to not insert/remove/modify digits in the original number passed
   1068    in.
   1069  - Fix formatOutOfCountryKeepingAlphaChars to not throw a NPE.
   1070 
   1071 * Metadata changes
   1072  - Updates for AR, BH, CI, CN, CR, DE, GA, IL, JO, JP, KE, KZ, LB, LK, LT, MV, MW, MZ, NA, NL, NZ,
   1073    PL, RO, SA, SV, TM, UG, US
   1074  - New country calling codes: 800, 808, 883, 888, 979
   1075  - Geocoding data updates: AR, US
   1076 
   1077 December 9th, 2011: libphonenumber-4.4
   1078 * Code changes
   1079  - Support for Voicemail numbers
   1080  - Support prefixes "xt" and "xtn" to indicate extensions of phone numbers
   1081  - Change formatInOriginalFormat to use raw_input for numbers with incorrect leading zeroes, instead
   1082    of all invalid numbers.
   1083 
   1084 * Metadata changes
   1085  - Updates for AR, BD, CH, CI, IL, IR, IS, IT, JP, KW, LR, MM, NG, SA, SC, UZ
   1086 
   1087 November 24th, 2011: libphonenumber-4.3
   1088 * Code changes
   1089  - Fix the problems with AYTF crashing for longer numbers entered with +CountryCode, and incorrectly
   1090    removing national prefix for some numbers.
   1091  - Improve PhoneNumberMatcher to not match numbers ending with '%'.
   1092  - Fix formatNumberForMobileDialing to handle Israeli star numbers, Peruvian and Colombian numbers.
   1093  - Modify formatInOriginalFormat to use the raw input if we don't have a formatting pattern for a
   1094    number.
   1095  - Simple offline geocoding function which takes into account the user's region.
   1096 
   1097 * Metadata changes
   1098  - Updates for CR, GN, JP, KE, PL, SG, SR, SX, TH, TK
   1099 
   1100 November 10th, 2011: libphonenumber-4.2
   1101 * Code changes
   1102  - Providing an "exact match" isEmergencyNumber method
   1103  - Improvement to PhoneNumberMatcher: requires national prefix to be present when matching
   1104    national-format numbers, unless matching for a region where it is explicitly marked in the
   1105    metadata that they may be omitted. Applies to leniency level VALID and higher.
   1106  - Change formatNumberForMobileDialing not to modify the phoneNumber passed in.
   1107 
   1108 * Metadata changes
   1109  - Emergency numbers added for all remaining countries
   1110  - Collected data on which numbers we format with a national prefix are commonly written without one
   1111    and added this
   1112  - Updates for AR, AT, BH, CZ, GR, IR, KM, LT, MX, PT, SE, SO, UG
   1113  - Addition of SX (Sint Maarten)
   1114 
   1115 October 19th, 2011: libphonenumber-4.1
   1116 * Code changes
   1117  - Update code and metadata for countries with IDD "8~10" to accept phone numbers where the "~" is
   1118    omitted.
   1119  - Modify formatInOriginalFormat to use raw_input (when present) when the number is considered as
   1120    invalid by the library.
   1121  - Add ShortNumberUtil to deal with international short phone numbers, such as short codes and
   1122    emergency numbers.
   1123  - Increase the maximum phone-number length accepted when parsing (now set to
   1124    16).
   1125 
   1126 * Metadata changes
   1127  - Updates: BF, BN, CN, DE, DK, DO, FR, IN, KI, KW, MC, MD, ML, PA, QA, SB, UK, WS
   1128  - Emergency number information also added to: AE, AF, AL, AM, AR, AT, AU, BA,
   1129    BB, BD, BE, BG, BH, BO, BR, BY, CA, CH, CL, CN, CO, CR, CY, CZ, DE, DJ, DK,
   1130    DO, DZ, EC, EE, EG, ES, FI, FJ, FO, FR, GB, GE, GF, GH, GI, GL, GR, GT, GY,
   1131    HK, HN, HR, HU, ID, IE, IL, IN, IR, IS, IT, JM, JO, JP, KR, KW, KY, KZ, LB,
   1132    LK, LT, LU, LV, MA, MC, MD, ME, MK, ML, MM, MN, MO, MT, MU, MV, MX, MY, NG,
   1133    NI, NL, NO, NP, OM, PA, PE, PH, PK, PL, PM, PT, PY, QA, RO, RS, RU, RW, SA,
   1134    SB, SD, SE, SG, SI, SK, SL, SM, SR, SV, SY, TD, TH, TJ, TM, TN, TR, TT, TW,
   1135    UA, UG, US, UY, UZ, VA, VE, VN, VU, ZA, ZM, ZW
   1136 
   1137 October 6th, 2011: libphonenumber-4.0
   1138 * Code changes
   1139  - New function formatNumberForMobileDialing, which attempts to format a number in such a way that
   1140    the call can be connected from a mobile phone. If this is impossible, for example for numbers
   1141    that cannot be internationally dialled, then an empty string is returned.
   1142  - Fallback functionality to English for non-CJK languages for geocoding
   1143 
   1144 * Metadata changes
   1145  - Collecting data for emergency numbers
   1146  - Updates: AR, AU, BR, CN, CZ, EG, GD, IE, IL, JM, KW, KH, SD, SO, TR, UG, UZ
   1147  - Geocoding data changes: AO, AR, AT, BJ, BR, CD, CG, CI, CL, CN, CV, DE, ES,
   1148    FR, GR, GW, HU, KM, MR, MZ, NL, PL, PT, SE, ST, SZ
   1149 
   1150 September 13th, 2011: libphonenumber-3.9
   1151 * Code changes
   1152  - Enable AsYouTypeFormatter to handle long IDD and NDD.
   1153  - Allow the presence of an IDD following a +.
   1154  - Fix formatting of phone numbers which contain only 0s in the national number.
   1155  - Refactored some code in geocoding including AreaCodeMap and the storage strategies.
   1156 
   1157 * Metadata changes
   1158  - Updates: AM, BE, BH, BJ, BR, BT, BZ, CI, CL, CN, DE, DK, DM, DZ, EC, EG, FJ,
   1159    GR, HR, HT, IN, IQ, IS, JM, KE, KG, KH, KR, LA, LB, LR, MA, MD, ML, MO, MX,
   1160    MY, NE, NG, PG, PH, PK, PY, QA, SA, SD, SG, SN, TD, TG, TH, TN, TT, UG, YE,
   1161    ZA, ZM
   1162  - New geocoding data for: AC, CG, CU, CV, EG, ET, FI, FI, FI, GL, JP, KM, MA,
   1163    MA, MU, MU, MU, MZ, RS, SH, SH, SL, SO, ST, TG, TG, TG, UG, ZM
   1164  - Updated geocoding data for: AR, DE
   1165 
   1166 August 11th, 2011: libphonenumber-3.8
   1167 * Code changes
   1168  - Fix to demo to not throw null-ptr exceptions for invalid NANPA numbers
   1169  - Fixed AYTF to not accept plus signs in the middle of input
   1170  - PhoneNumberMatcher improvements - added STRICT_GROUPING and EXACT_GROUPING levels, numbers
   1171    followed/preceded by a currency symbol will not match, multiple numbers separated by phone-number
   1172    punctuation will now match. ", " is no longer accepted as an extension symbol when matching, only
   1173    when parsing. "x" is only accepted as a carrier code or extension marker, not otherwise.
   1174  - Changes to handling of leading zeroes - these will not be silently ignored anymore, but will be
   1175    stored as part of the number.
   1176  - PhoneNumberOfflineGeocoder - new method to get the description of a number that assumes the
   1177    validity of the number has already been checked and will not re-verify it.
   1178  - Split geocoding US binary data into multiple files.
   1179 
   1180 * Metadata changes
   1181  - Updates: AR, AT, AU, AZ, BE, BF, BH, BY, CA, CN, CO, CR, HT, HU, IT, KG, KH,
   1182    LB, LI, ME, NC, RS, SE, TT, US, VG, ZA
   1183  - New geocoding data for: AL, AM, AO, BF, BJ, BW, CD, CI, CZ, DZ, EE, GH, GM,
   1184    GN, GR, GW, HU, IS, KE, LK, LS, LT, LU, LV, MD, MG, MR, NA, PE, QN, SD, SK,
   1185    SN, SZ, TN, VE, VN, ZA, ZW
   1186  - Updated geocoding data for: GB, PT, US
   1187  - Revised sorting of geocoding data
   1188 
   1189 July 5th, 2011
   1190 * Code changes
   1191  - Refactored AreaCodeMap to minimize binary and memory footprint by using 2 different strategies.
   1192  - Refactored BuildMetadataFromXml.java and added unittests.
   1193 
   1194 * Metadata changes
   1195  - Regenerate binaries for all existing area code mapping data with smaller sizes.
   1196  - Added city-level area code data mapping for US and Canada.
   1197 
   1198 June 29th, 2011
   1199 * Code changes
   1200  - Fixed issue 38, issue 39, issue 41 and issue 43
   1201 
   1202 * Metadata changes
   1203  - Added phone number area mapping files for
   1204    - JP in Japanese
   1205    - FR in French
   1206    - TW in English, Simplified and Traditional Chinese
   1207    - RU in English
   1208    - IT in English and Italian
   1209    - PT in Portuguese
   1210    - TR in English and Turkish
   1211    - CH in English, German, French and Italian
   1212  - Updates: CR, GE, IT, JP, KW, MH, MP, MU, PE, PM, RW, TG, TJ, TK
   1213 
   1214 June 14th, 2011
   1215 * Code changes
   1216  - Added PhoneNumberOfflineGeocoder, supporting classes and their unittests.
   1217  - Added GenerateAreaCodeData to transform phone number area mapping files from text files to binary
   1218    files.
   1219  - Modified PhoneNumberParserServlet.java and phonenumberparser.jsp to incorporate
   1220    PhoneNumberOfflineGeocoding in the appengine demo.
   1221 
   1222 * Metadata changes
   1223  - Added phone number area mapping files for NANPA countries and GB in English, NL in Dutch, AR, CL
   1224    and ES in Spanish, AT and DE in German, SE in Swedish, BR in Portuguese, KR in English, Korean,
   1225    Simplified and Traditional Chinese, and CN in Simplified Chinese.
   1226 
   1227 June 10th, 2011
   1228 * Code changes:
   1229  - Fixes for PhoneNumberMatcher to be more restrictive in valid mode and not match numbers
   1230    surrounded by Latin characters. This ensures, for example, the string abc123456789acg will not be
   1231    marked as a phone numbers.
   1232  - Enable PhoneNumberUtil to handle all digits, rather than a subset
   1233  - Fix for AYTF issue36 and improvement for US AYTF behaviour.
   1234 * Metadata changes:
   1235  - Updates: BG, EG, ES, GH, PF, SC, SY, VA
   1236 
   1237 May 24th, 2011
   1238 * Code changes:
   1239  - Phonenumber now implements Serializable.
   1240  - findNumbers doesn't accept numbers with mis-matched brackets as phone-numbers
   1241  - An offline phone number geocoder has been added. The current implementation just returns the
   1242    region name for the phone number; more detailed geocoding will be added later.
   1243 * Metadata changes:
   1244  - New countries: GF, KP, NC, PA, PF, PW, PY, SB, SR, TO, UY, VU
   1245  - Updates: CY, CZ, ES, GB, GQ, JM, MQ, TN, VI
   1246 
   1247 May 9th, 2011
   1248 * Code changes:
   1249  - Fixed potential for a null-ptr exception in getExampleNumber
   1250  - Potential speed improvement with replacement of StringBuffer with StringBuilder
   1251 * Metadata changes
   1252  - Changed way that international formats are specified to make it easier to do so
   1253  - New countries: AX, CC, CX, WF
   1254  - Updates: AM, AR, AU, AW, CN, CO, CR, DM, EC, ET, FI, FJ, GH, IN, JP, KE, KM,
   1255    KN, LR, MD, MQ, MX, NP, PH, SC, SE, SM, SN, SY, UG, US, VC, VI, ZM
   1256 
   1257 Apr 26th, 2011
   1258 * Code changes:
   1259  - Improved PhoneNumberMatcher for cases with other numbers before or after the phone number.
   1260  - Improved AsYouTypeFormatter not to use formatting rules containing non-formatting characters
   1261    (e.g. '*' in Israeli star numbers).
   1262 * Metadata changes:
   1263  - New countries: FJ, FM, GY, NF, NI, NR, TV.
   1264  - Updates: AM, AZ, BF, BW, BZ, CI, CR, GB, GP, HK, JM, KH, LB, LY, MV, PE, PK, SZ, TJ, US.
   1265 * Minor documentation updates
   1266 
   1267 Apr 11th, 2011
   1268 * Bug fixes:
   1269  - Adding date exclusion pattern in PhoneNumberMatcher.
   1270  - Fixing bug with selecting a suitable region for numbers with leading zeros where mutiple regions
   1271    for that country code are possible.
   1272 * Metadata changes:
   1273  - Updates: AG, AI, AS, BB, BM, BS, CA, DM, DO, ET, FO, GD, GE, GU, IN, JM, KN, KY, LC, MN, MP, MR,
   1274    MS, NO, PR, TC, TR, TT, US, VC, VG, VI
   1275  - New countries: CK, FK, GT, IO, KI, SJ, SV
   1276 * Documentation updates and some small refactoring to AsYouTypeFormatter
   1277 
   1278 Mar 31st, 2011
   1279 * New functionality:
   1280  - Can parse and format numbers in RFC-3966 format.
   1281  - Added isAlphaNumber to check to see if a number is a "vanity" or "alpha" number
   1282  - Can format a number made up of alpha-characters in an "out-of-country" format (e.g. 0011 1
   1283    800-SIX-FLAG to dial an American alpha-number from Australia).
   1284 * Code changes:
   1285  - Renamed private vars, private methods and fixed comments to try and differentiate between country
   1286    (calling) codes and region codes.
   1287  == Non-backwards-compatible API changes: ==
   1288  - Renamed getSupportedCountries to getSupportedRegions, as this more accurately reflects that the
   1289    library is based around region codes.
   1290  - getNationalSignificantNumber is no longer a static method, but is instead an instance method.
   1291 * Metadata changes:
   1292  - Bug-fixes and updates for AU, AZ, EE, FI, IN, JO, KW, KZ, MV, RU, RR, VA
   1293  - New country: ME
   1294 
   1295 Mar 22nd, 2011
   1296 * Metadata changes:
   1297  - New mobile-number pattern for AU
   1298 
   1299 Mar 10th, 2011
   1300 * New functionality:
   1301  - New function to format a number with the preferred domestic carrier code used when parsing,
   1302    falling back to a default calling code otherwise (formatNationalNumberWithPreferredCarrierCode).
   1303  - We now store the preferred domestic carrier code used when the user calls parseAndKeepRawInput
   1304  - New functionality to extract phone-numbers from text (findNumbers). This is just the first
   1305    version - it does not extract ALPHA numbers such as 0800 CALL ME, or numbers where alternate
   1306    endings are specified (such as 03-331 6005/6006).
   1307 * Code changes:
   1308  - Tidying up the test file to use several pre-defined phone number constants
   1309  - Fixing several lint errors
   1310  - Added javadoc to formatNationalNumberWithCarrierCode
   1311  - Fixed bug where a null pointer exception was thrown when getAsYouTypeFormatter was called with an
   1312    invalid region code
   1313  - Improved AsYouTypeFormatter to deal with countries with variable-length patterns such as LU
   1314 * Metadata changes:
   1315  - Bug-fixes and updates for the following countries: BF, BO, BR, CL, CO, CR, DK, FO, GE, KR, KW,
   1316    LA, LU, MU, SC, SH, TR, VE
   1317  - New country: SH
   1318 
   1319 Mar 10th, 2011
   1320 * Code changes:
   1321   - releasing the code to run the demo on localhost or appengine.
   1322 
   1323 Mar 7th, 2011
   1324 * Metadata changes:
   1325  - Adding support for AC
   1326 
   1327 Feb 11th, 2011
   1328 * Metadata changes:
   1329  - Update UAN number ranges for IM and JE.
   1330 
   1331 Feb 9th, 2011
   1332 * Code changes:
   1333   - Better isNumberMatch method. This will now recognise numbers starting with a national prefix as
   1334     an NSN_MATCH, instead of SHORT_NSN_MATCH.
   1335     == Note Non-backwards-compatible API change here! ==
   1336       This will no longer throw a NumberParseException - instead we will return NOT_A_NUMBER if one
   1337       or other of the numbers provided do not match.
   1338   - New number-type UAN now supported in the code. This represents Company Numbers or Universally
   1339     Accessible Numbers.
   1340 * Metadata changes:
   1341   - Bug-fixes and updates for the following countries: AG, AZ, BA, BE, CA, CU, ES, FI, GB, GD, GG,
   1342     IE, IL, IM, IN, IR, IT, JE, JP, KR, KW, NG, NZ, PK, PS, PT, RU, SE, SG, SY, US
   1343   - New countries: CO, LU, LY, MC, SM
   1344   - Addition of "Personal Number" ranges to all NANPA countries
   1345 
   1346 Jan 31st, 2011
   1347 * Code changes:
   1348   - Introducing equals() and hashCode() methods for the Phonenumber.PhoneNumber class
   1349 
   1350 Jan 28th, 2011
   1351 * Code changes:
   1352   - Fixing critical bug with non-Android-compatible code. isEmpty() was being used and CANON_EQ in
   1353     reg-ex matches.
   1354 
   1355 Jan 20th, 2011
   1356 * Code improvements:
   1357   - Handle null phone-numbers when parsing by throwing a NumberParseException.
   1358   - Handle extension written with an accented "o", as per Spanish, when parsing.
   1359   - Handle U+30FC dashes as phone-number punctuation.
   1360   - Allow "ZZ" or null regions to be specified for numbers starting with a full-width "+" symbol, or
   1361     with other characters (such as whitespace) before the leading +.
   1362   - new getLengthOfNationalDestinationCode function
   1363 * Metadata changes:
   1364   - New types of numbers introduced: UAN (universal or "company" numbers) and short codes. Note that
   1365     "generalDesc" patterns do not encompass short-codes.  No code-support for these has been
   1366     introduced as of yet. We are also now enabling the collection of data for information such as
   1367     area-code-optional, and no-international-dialling ranges.
   1368   - Data updates as per ITU notifications/bug fixes for the following countries: AM, BH, CD, CG, CR,
   1369     DE, DJ, EE, GB, GN, HU, IE, JO, JP, LB, LR, MA, MK, MN, MR, NA, PG, SC, SG, SO, SZ, VN, ZA, ZW
   1370   - Data added for the following countries: BZ, CU, EC, FO, GI, HN, HT, LK, MT, MV, NU, PS, SD
   1371   - Indentation fixes in reg-exes for the following countries: BG, GB
   1372   - Allow nationalPrefixForParsing to be specified for countries with no national prefix, to handle
   1373     possible carrier prefixes
   1374 
   1375 Jan 3rd, 2011
   1376 * Metadata changes:
   1377   - Updates to JE
   1378   - Updated comments for GB/GG/IM/JE
   1379 
   1380 November 25th, 2010
   1381 * Metadata changes:
   1382   - Updates to existing countries: AD, AG, AI, AN, AS, BB, BG, BM, BS, BW, CA, DM, DO, GD, GH, GM,
   1383     GU, IN, JM, KN, KY, KZ, LB, LC, MP, MS, PR, SY, TC, TT, TZ, US, VC, VG, VI.
   1384   - Reorganize reg-exes for better readability.
   1385   - Updated comments.
   1386 
   1387 October 22nd, 2010
   1388 * Metadata changes:
   1389   - Updates to existing countries: AE, GB, GG, IM, JE
   1390 
   1391 October 15th, 2010
   1392 * Code improvements:
   1393   - Allowed parsing of numbers that start with "++" or a full-width "+" symbol
   1394   - Allowed reg-exes for national and possible number patterns to have white space in them in the
   1395     source XML file
   1396   - Added a more useful toString method for the phone number proto class
   1397 * Metadata changes:
   1398   - Updates to existing countries: AF, BF, BO, ES, GB, GG, IM, IS, JE, JE, JP, KR, PE, PT, RU, SE,
   1399     TT, ZW
   1400 * Bug fixes:
   1401   - Parsing empty strings with invalid region codes no longer throws a null pointer exception
   1402 
   1403 September 4th, 2010
   1404 * Code improvement:
   1405   - Added new phone number type: pager
   1406 * Metadata change:
   1407   - update to existing country: GG, IM, JE, RS, RU
   1408 * Bug fixes:
   1409   - ArrayOutOfBoundException in AsYouTypeFormatter.getRememberedPosition()
   1410   - AsYouTypeFormatter for UK childline number
   1411 
   1412 September 1st, 2010
   1413 * Bug fix on KZ metadata.
   1414 
   1415 August 17th, 2010
   1416 * Code improvement:
   1417   - Refactored BuildMetadataProtoFromXml.java into BuildMetadataFromXml.java and
   1418     BuildMetadataProtoFromXml.java
   1419   - Added BuildMetadataProtoFromXml.java and JSArrayBuilder.java
   1420   - Refactored CountryCodeToRegionCodeMap and CountryCodeToRegionCodeMapForTesting into separate
   1421     files.
   1422 
   1423 August 16th, 2010
   1424 * Bug fixes
   1425   - AsYouTypeFormatter for formatting Chinese geographical numbers entered in national format.
   1426   - AsYouTypeFormatter for formatting Chinese 400/800 numbers entered in national format.
   1427 * Metadata change:
   1428   - new countries: AM, AN, BH, GL, IS
   1429   - adding national prefix 1 to all NANPA countries.
   1430   - update to existing countries: BF, FR, UK, PK, RE
   1431 
   1432 August 4th, 2010
   1433 * Further improve startup performance
   1434   - Preload no country specific metadata at startup.
   1435   - Stop creating the file containing mapping from country calling code to region code and loading
   1436     it at startup; instead, do the initialization in PhoneNumberUtil.
   1437 
   1438 July 31th, 2010
   1439 
   1440 * Improve startup performance
   1441   - Separate generated metadata binary file to one file per region
   1442   - Preload US at start up, and load other region at the time when needed
   1443   - Create a file containing mapping from country calling code to region code, and load it at
   1444     startup
   1445   - Same change also applied to unittests
   1446 
   1447 July 30th, 2010
   1448 * Metadata change:
   1449   - new country: TL
   1450   - update to existing country: AZ, CN, FR, GH, JO, LA, PG, PK, QA, SZ, UA, VN
   1451 
   1452 * Code improvement
   1453   - China local number formatting for AsYouTypeFormatter
   1454   - improve extension parsing to handle number in the form of +1 (645) 123 1234 ext. 910#
   1455