Home | History | Annotate | Download | only in libphonenumber
      1 Sep 16, 2015: libphonenumber-7.0.11
      2 Metadata changes:
      3  - Updated phone metadata for region code(s):
      4    IN, KE, LR, MM, MR, NA, NE, PT, RO, SO, TZ, US
      5  - New short number metadata for region code(s): CF, CG, ER, KP, NE, SO
      6  - Updated short number metadata for region code(s): CD, NO, PT
      7  - New geocoding data for country calling code(s): 1854 (en)
      8  - Updated geocoding data for country calling code(s): 264 (en)
      9  - Updated carrier data for country calling code(s):
     10    40 (en), 91 (en), 95 (en), 227 (en), 231 (en), 252 (en), 254 (en), 255 (en),
     11    509 (en)
     12 
     13 Aug 31, 2015: libphonenumber-7.0.10
     14 Metadata changes:
     15  - Updated phone metadata for region code(s):
     16    AU, BY, CR, DZ, EH, ES, HK, HT, IN, JO, MN, MU, ST, TD, TT, ZW
     17  - Updated short number metadata for region code(s): HK, KR
     18  - Updated geocoding data for country calling code(s): 263 (en)
     19  - New carrier data for country calling code(s): 509 (en), 976 (en)
     20  - Updated carrier data for country calling code(s):
     21    41 (en), 61 (en), 91 (en), 230 (en), 235 (en), 239 (en)
     22 
     23 Aug 03, 2015: libphonenumber-7.0.9
     24 Metadata changes:
     25  - Updated phone metadata for region code(s): AR, IN, MX, PL, SZ, YT, ZW
     26  - Updated short number metadata for region code(s): MX, ZW
     27  - Updated carrier data for country calling code(s): 91 (en), 263 (en)
     28 
     29 Jul 14, 2015: libphonenumber-7.0.8
     30 Metadata changes:
     31  - Updated phone metadata for region code(s):
     32    AC, BS, BW, CL, DE, DZ, HN, HR, IL, IN, IT, JO, KY, MA, NP, PL, SH, SL, TM,
     33    UA, VA
     34  - Updated short number metadata for region code(s): HR
     35  - Updated geocoding data for country calling code(s): 56 (en, es)
     36  - Updated carrier data for country calling code(s):
     37    49 (en), 212 (en), 232 (en), 267 (en), 380 (en), 385 (en), 962 (en),
     38    972 (en), 977 (en), 993 (en)
     39 - Updated / refreshed time zone meta data.
     40 
     41 Jun 24, 2015: libphonenumber-7.0.7
     42 Metadata changes:
     43  - Updated phone metadata for region code(s):
     44    AC, BF, BG, CG, CM, FR, IL, IN, JP, KW, LB, LI, SB, SD, SH, TT
     45  - Updated short number metadata for region code(s): GY, SB
     46  - New geocoding data for country calling code(s): 592 (en)
     47  - Updated geocoding data for country calling code(s):
     48    86 (en, zh), 226 (en), 290 (en, fr)
     49  - New carrier data for country calling code(s): 592 (en), 689 (en)
     50  - Updated carrier data for country calling code(s):
     51    7 (en), 60 (en), 91 (en), 237 (en), 242 (en), 249 (en), 359 (en), 961 (en),
     52    1868 (en)
     53 - Updated / refreshed time zone meta data.
     54 
     55 May 29, 2015: libphonenumber-7.0.6
     56 Metadata changes:
     57  - Updated phone metadata for region code(s):
     58    BB, BR, CR, ID, IL, JO, KW, LK, LU, MD, MM, MV, MY, PH, PK, SC, SE
     59  - Updated short number metadata for region code(s): BE, LK, US
     60  - Updated carrier data for country calling code(s):
     61    60 (en), 63 (en), 92 (en), 94 (en), 95 (en), 248 (en), 373 (en), 960 (en),
     62    972 (en), 1246 (en)
     63 
     64 Apr 24, 2015: libphonenumber-7.0.5
     65 * Metadata changes:
     66  - Updated phone metadata for region code(s):
     67    AF, AS, BD, BE, CA, CI, ID, IN, JM, KH, LI, LU, MU, NE, PL
     68  - Updated short number metadata for region code(s): BE, LI
     69  - Updated geocoding data for country calling code(s):
     70    62 (en), 86 (en, zh), 358 (en, fi, se)
     71  - Updated carrier data for country calling code(s):
     72    32 (en), 93 (en), 225 (en), 227 (en), 855 (en), 1684 (en), 1876 (en)
     73 
     74 Mar 25, 2015: libphonenumber-7.0.4
     75 * Metadata changes:
     76  - Updated phone metadata for region code(s): CA, HU, IL, JO, LU, SG, SL, US
     77  - Updated short number metadata for region code(s): BI
     78  - New geocoding data for country calling code(s):
     79    1220 (en), 1628 (en), 1629 (en)
     80  - Updated carrier data for country calling code(s):
     81    65 (en), 232 (en), 972 (en)
     82 
     83 Mar 02, 2015: libphonenumber-7.0.3
     84 * Metadata changes:
     85  - Updated phone metadata for region code(s):
     86    AR, BH, BY, CI, CN, GH, KR, KW, LU, ME, NZ, SB, WS
     87  - New geocoding data for country calling code(s): 64 (en)
     88  - Updated geocoding data for country calling code(s):
     89    86 (en, zh), 1418 (en), 1438 (en), 1450 (en), 1514 (en), 1819 (en)
     90  - Updated carrier data for country calling code(s):
     91    225 (en), 233 (en), 677 (en), 973 (en)
     92 
     93 Jan 09, 2015: libphonenumber-7.0.2
     94 * Metadata changes:
     95  - Updated phone metadata for region code(s):
     96    BD, BH, EH, GH, IN, JM, LU, MA, MY, NF, NG, PK, SB, TT, TZ
     97  - Updated geocoding data for country calling code(s): 91 (en), 352 (en, fr)
     98  - New carrier data for country calling code(s): 1876 (en)
     99  - Updated carrier data for country calling code(s):
    100    60 (en), 91 (en), 92 (en), 212 (en), 233 (en), 234 (en), 352 (en), 677 (en)
    101 
    102 Nov 25, 2014: libphonenumber-7.0.1
    103 * Metadata changes:
    104  - New alternate formatting data for country calling code(s): 676
    105  - Updated phone metadata for region code(s):
    106    BI, CM, ID, IR, KR, LA, NP, TG, TH, TO
    107  - New geocoding data for country calling code(s): 237 (en)
    108  - Updated geocoding data for country calling code(s): 98 (en, fa)
    109  - Updated carrier data for country calling code(s):
    110    237 (en), 257 (en), 856 (en), 977 (en)
    111 
    112 Oct 29, 2014: libphonenumber-7.0
    113 * Code changes:
    114  - New APIs for ShortNumberInfo. The old APIs have been deprecated and will be
    115    removed in an upcoming release.
    116 * Metadata changes:
    117  - Updated phone metadata for region code(s):
    118    AR, AU, CC, CI, CX, DZ, EE, IN, KZ, MC, SB, TJ, TT
    119  - Updated short number metadata for region code(s): MC
    120  - Updated geocoding data for country calling code(s): 34 (en, es), 54 (en)
    121  - Updated carrier data for country calling code(s):
    122    7 (en), 61 (en), 91 (en), 225 (en), 677 (en), 967 (en), 992 (en), 1868 (en)
    123 
    124 Oct 13, 2014: libphonenumber-6.3.1
    125 * Metadata changes:
    126  - Updated phone metadata for region code(s):
    127    AC, AU, CR, DE, IL, MR, NO, SA, SR, UG
    128  - Updated short number metadata for region code(s): CR
    129  - Updated carrier data for country calling code(s):
    130    61 (en), 256 (en), 506 (en), 597 (en), 966 (en), 972 (en)
    131 
    132 Sep 25, 2014: libphonenumber-6.3
    133 * Code changes:
    134   - Changing the offline geocoder to not return any country at all if the number
    135     could belong to multiple countries
    136   - Removing obsolete code that treated countries with no metadata as valid.
    137 * Metadata changes:
    138  - New alternate formatting data for country calling code(s): 54, 91
    139  - Updated phone metadata for region code(s):
    140    AM, AR, BR, CA, CL, IL, IN, IR, IS, KE, NI, PF, SB, SN, TH, TN, US
    141  - New geocoding data for country calling code(s):
    142    1782 (en), 1929 (en), 1930 (en), 1938 (en)
    143  - Updated geocoding data for country calling code(s): 98 (en, fa)
    144  - New carrier data for country calling code(s): 354 (en)
    145  - Updated carrier data for country calling code(s):
    146    27 (en), 56 (en), 66 (en), 91 (en), 92 (en), 98 (en), 216 (en), 221 (en),
    147    254 (en), 374 (en), 505 (en), 677 (en), 972 (en)
    148 
    149 Aug 21, 2014: libphonenumber-6.2.2
    150 * Metadata changes:
    151  - Updated phone metadata for region code(s): BN, CL, CO, DK, IN, SB, SO
    152  - Updated short number metadata for region code(s): FR, SA, US
    153  - Updated carrier data for country calling code(s):
    154    27 (en), 57 (en), 91 (en), 252 (en), 677 (en)
    155 
    156 Jul 28, 2014: libphonenumber-6.2.1
    157 * Metadata changes:
    158  - Updated phone metadata for region code(s): BW, LB, MD, PA, PF, VI, ZM
    159  - New carrier data for country calling code(s): 507 (en), 961 (en)
    160  - Updated carrier data for country calling code(s): 267 (en), 373 (en)
    161 
    162 Jun 30, 2014: libphonenumber-6.2
    163 * Code changes:
    164  - Better exclusion of dates when matching phone numbers from text.
    165  - Handle phone input in RFC3966 with missing tel: prefix
    166 
    167 * Metadata changes:
    168  - New alternate formatting data for country calling code(s): 95
    169  - Updated phone metadata for region code(s):
    170    AF, CN, EH, FJ, IN, JP, KE, KG, KW, MA, MM, PG, PK, SN, SO
    171  - New short number metadata for region code(s): SN
    172  - Updated short number metadata for region code(s): FR, KE
    173  - Updated geocoding data for country calling code(s): 254 (en)
    174  - New carrier data for country calling code(s): 95 (en)
    175  - Updated carrier data for country calling code(s):
    176    92 (en), 93 (en), 212 (en), 221 (en), 254 (en), 675 (en), 679 (en), 965 (en),
    177    996 (en)
    178 
    179 Jun 06, 2014: libphonenumber-6.1.1
    180 * Metadata changes:
    181  - Updated phone metadata for region code(s):
    182    AF, AG, AI, AS, BB, BF, BM, BS, CA, CN, CR, DM, DO, DZ, FR, GD, GU, IN, JM,
    183    KH, KN, KW, KY, LC, MN, MP, MS, NG, NI, PH, PR, SX, TC, TT, US, VC, VG, VI
    184  - Updated short number metadata for region code(s): AL
    185  - New geocoding data for country calling code(s): 1346 (en), 1959 (en)
    186  - Updated geocoding data for country calling code(s):
    187    33 (en, fr), 352 (de, en, fr), 355 (en)
    188  - New carrier data for country calling code(s): 505 (en)
    189  - Updated carrier data for country calling code(s):
    190    63 (en), 91 (en), 93 (en), 234 (en)
    191 
    192 May 08, 2014: libphonenumber-6.1
    193 * Code changes:
    194  - Adding MetadataLoader support to allow custom metadata loading from
    195    alternative sources (should have no visible impact to users).
    196  - Fixing bug where digits could be lost in as-you-type formatting and
    197    formatting patterns incorrectly applied.
    198 
    199 * Metadata changes:
    200  - Updated phone metadata for region code(s):
    201    AR, BF, BR, BS, CL, CN, CO, CR, DE, DM, EC, EG, FR, GA, GD, GH, HU, ID, IL,
    202    IN, JP, KH, KI, KN, LA, LC, LR, ML, MU, MX, MZ, NA, NE, PF, PL, RU, SM, TH,
    203    TW, UZ, VA, VC
    204  - Updated short number metadata for region code(s): BI, CR, PL, TH
    205  - New geocoding data for country calling code(s): 32 (de), 1242 (en)
    206  - Updated geocoding data for country calling code(s):
    207    32 (en, nl), 55 (en), 56 (en, es), 86 (en, zh)
    208  - New carrier data for country calling code(s):
    209    1758 (en), 1784 (en), 1869 (en)
    210  - Updated carrier data for country calling code(s):
    211    66 (en), 86 (en), 227 (en), 231 (en), 233 (en), 258 (en), 1473 (en),
    212    1767 (en)
    213 
    214 Feb 25, 2014: libphonenumber-6.0
    215 * Code changes:
    216  - Better support for detecting phone numbers in text that are beside each other
    217  - Change to how Japanese numbers beginning with "00" are modelled, with the
    218    side-effect that the maximum possible number length has been extended by 1.
    219  - Handle StringIndexOutOfBoundsException in the AsYouTypeFormatter when the
    220    national prefix that was extracted was not found in the prefix. This affected
    221    countries with very long carrier codes, such as Korea.
    222  - Removal of some of the author attributions - contributions to be tracked in
    223    CONTRIBUTORS file.
    224 * Metadata changes:
    225  - Updated phone metadata for region code(s): AS, BR, KW, LU
    226  - New carrier data for country calling code(s): 1684 (en)
    227  - Updated carrier data for country calling code(s): 352 (en)
    228 
    229 Feb 07, 2014: libphonenumber-5.9.4
    230 * Metadata changes:
    231  - Updated phone metadata for region code(s):
    232    883, BF, BJ, BW, CL, CR, DZ, FR, GD, IN, JP, MD, NG, NZ, PK, PL, SY, UY, VU
    233  - Updated short number metadata for region code(s): LV, MD
    234  - New carrier data for country calling code(s): 373 (en), 1473 (en)
    235  - Updated carrier data for country calling code(s):
    236    48 (en), 49 (en), 91 (en), 92 (en), 213 (en), 226 (en), 229 (en), 234 (en),
    237    267 (en), 389 (en), 506 (en), 598 (en)
    238 
    239 Jan 21, 2014: libphonenumber-5.9.3
    240 * Metadata changes:
    241  - Updated phone metadata for region code(s):
    242    BF, BH, BR, CN, GR, IN, MY, PA, TN, US
    243  - Updated short number metadata for region code(s): CN
    244  - New geocoding data for country calling code(s): 1364 (en), 1725 (en)
    245  - Updated geocoding data for country calling code(s): 86 (en)
    246  - Updated carrier data for country calling code(s):
    247    55 (en), 226 (en), 973 (en)
    248 
    249 Dec 20, 2013: libphonenumber-5.9.2
    250 * Metadata changes:
    251  - New alternate formatting data for country calling code(s): 255, 27, 381, 506
    252  - Updated alternate formatting data for country calling code(s): 43
    253  - Updated phone metadata for region code(s):
    254    AG, AI, AS, BB, BF, BM, BS, CA, CR, DM, DO, EC, GD, GU, JM, KN, KY, LC, MP,
    255    MS, PR, SO, SX, TC, TT, US, VC, VG, VI
    256  - Updated carrier data for country calling code(s): 226 (en)
    257 
    258 Dec 13, 2013: libphonenumber-5.9.1
    259 * Metadata changes:
    260  - New alternate formatting data for country calling code(s): 505, 679
    261  - Updated phone metadata for region code(s):
    262    BF, CI, EG, EH, FJ, IN, KI, MA, MT, NG, NI, SI, SN, SR, TT
    263  - Updated short number metadata for region code(s): KI
    264  - Updated geocoding data for country calling code(s):
    265    27 (en), 226 (en), 1 (en)
    266  - New carrier data for country calling code(s): 356 (en), 677 (en)
    267  - Updated carrier data for country calling code(s):
    268    212 (en), 221 (en), 225 (en), 226 (en), 234 (en), 597 (en), 1 (en)
    269 
    270 Nov 12, 2013: libphonenumber-5.9
    271 * Code changes:
    272  - Adding support for numbers with multiple Italian leading zeros, by adding a field
    273    to the phone number proto to allow an arbitrary number of leading zeros, and
    274    supporting this when parsing, validating and formatting.
    275  - Adding more functionality to ShortNumberInfo -> such as getExpectedCostForRegion.
    276  - Fix for parsing short numbers that start with the national prefix.
    277  - Updating formatNumberForMobileDialing to work with short numbers.
    278  - Stop finding Israeli 4-digit "star" numbers in text when no star is in fact present.
    279  - Bug fix for finding phone numbers where the area code was also part of the country
    280    calling code.
    281 
    282 * Metadata changes:
    283  - Updated phone metadata for region code(s):
    284    AU, BQ, BY, CI, CO, CW, GN, HN, IN, JO, KI, KW, MG, MK, MM, NA, PK, TC, TM,
    285    UG
    286  - New short number metadata for region code(s): CD, GN
    287  - Updated short number metadata for region code(s):
    288    AF, AG, AI, AM, AR, AS, AW, AZ, BD, BH, BI, BM, BO, BQ, BT, BW, BY, CA, CH,
    289    CI, CM, CO, CW, DZ, FJ, GD, GE, GH, GT, GY, HN, HT, ID, IE, IM, IN, IQ, JM,
    290    JO, KE, KG, KH, KI, KW, KZ, LR, SV
    291  - New geocoding data for country calling code(s):
    292    257 (en), 389 (en), 599 (en), 686 (en), 962 (en)
    293  - Updated geocoding data for country calling code(s):
    294    264 (en), 375 (be, en, ru)
    295  - New carrier data for country calling code(s):
    296    375 (be, ru), 389 (en), 599 (en), 965 (ar)
    297  - Updated carrier data for country calling code(s):
    298    57 (en), 61 (en), 92 (en), 225 (en), 256 (en), 257 (en), 261 (en), 375 (en),
    299    686 (en), 962 (en), 965 (en)
    300 
    301 Oct 10, 2013: libphonenumber-5.8.8
    302 * Metadata changes:
    303  - New alternate formatting data for country calling code(s):
    304    350, 358, 36, 66, 84, 94, 995
    305  - Updated alternate formatting data for country calling code(s):
    306    31, 359, 372, 49, 62, 7
    307  - Updated phone metadata for region code(s):
    308    AR, BD, BE, BF, BR, CO, CR, FI, GI, GM, IS, MU
    309  - Updated short number metadata for region code(s): AR, BE, ES, GI, PG, US
    310  - Updated geocoding data for country calling code(s): 220 (en)
    311  - Updated carrier data for country calling code(s):
    312    20 (en), 220 (en), 224 (en), 230 (en), 852 (en)
    313 
    314 Oct 8, 2013: libphonenumber-5.8.7
    315 * Code changes:
    316   - New method in the PhoneNumberUtil API - isMobileNumberPortableRegion.
    317   - Carrier mapper: Updated API and added a getSafeDisplayName method that only returns the carrier
    318                     if it's safe to display to the user.
    319 
    320 Oct 7, 2013:
    321 * Code changes:
    322   - Added PhoneNumberToTimeZonesMapper including unittests to the geocoder maven project.
    323   - Added build rules for generating the binary time zones mapping file from the text file.
    324   - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate time zone mapping.
    325 * Metadata changes:
    326   - Added the time zone mapping file.
    327 
    328 Sep 30, 2013:
    329 * Code changes:
    330   - Added PhoneNumberToCarrierMapper including unittests.
    331   - Added build rules for generating binary carrier mapping files from text files.
    332   - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate carrier mapping.
    333 * Metadata changes:
    334   - Added carrier mapping files for some NANPA countries, EG, SS, MA, DZ, TN, GM, SN, MR, ML, GN,
    335     CI, BF, NE, TG, BJ, MU, LR, SL, GH, NG, TD, CF, CM, CV, ST, GQ, GA, CG, CD, AO, GW, SC, SD, RW,
    336     ET, SO, DJ, KE, TZ, UG, BI, MZ, ZM, MG, ZW, MW, BW, SZ, ZA, AW, FO, GL, GR, NL, BE, FR, GI, PT,
    337     LU, IE, AL, CY, FI, BG, HU, LT, EE, AM, BY, AD, UA, RS, HR, SI, BA, IT, RO, CH, CZ, SK, AT, DK,
    338     NO, PL, DE, BZ, CR, PE, CU, AR, BR, CL, CO, VE, BO, PY, SR, UY, MY, AU, ID, PH, NZ, SG, TH, TL,
    339     BN, PG, TO, VU, FJ, WS, KI, RU, VN, HK, KH, LA, CN, BD, TR, IN, PK, AF, LK, MV, JO, IQ, KW, SA,
    340     YE, OM, PS, AE, IL, BH, QA, BT, NP, IR, TJ, TM, AZ, GE, KG and UZ in English.
    341 
    342 Sep 23, 2013: libphonenumber-5.8.6
    343 * Code changes:
    344   - Restructured the geocoder binary generation code, moving the classes under tools/ from
    345     geocoding/ to buildtools/ and renaming AreaCode to PhonePrefix.
    346 
    347 Sep 23, 2013: libphonenumber-5.8.5
    348 * Code changes:
    349   - Restructured the geocoder, moving the utility classes to a new module internal/prefixmapper.
    350 
    351 Sep 20, 2013: libphonenumber-5.8.4
    352 * Metadata changes:
    353  - Adding a token to indicate which countries have mobile portability.
    354 
    355 Sep 20, 2013: libphonenumber-5.8.3
    356 * Code changes:
    357   - PhoneNumberOfflineGeocoder: Moved utility functionality to PrefixFileReader.
    358   - Bug fix: Argentinian (and other countries with mobile tokens) mobile numbers now geocode
    359              correctly.
    360 
    361 Sep 19, 2013: libphonenumber-5.8.2
    362 * Code changes:
    363   - New method in the PhoneNumberUtil API - getCountryMobileToken.
    364 
    365 Sep 19, 2013: libphonenumber-5.8.1
    366 * Metadata changes:
    367  - New alternate formatting data for country calling code(s): 675
    368  - Updated phone metadata for region code(s):
    369    AO, AU, BF, BW, CA, CH, CI, CN, DE, FR, MA, MR, MU, NI, PG, SA, SE, US, VI
    370  - New short number metadata for region code(s): IQ
    371  - Updated short number metadata for region code(s):
    372    AU, BR, DO, EG, FR, GH, ID, IL, JM, KE, KZ, LR, MW, NG, NI, SA, SE, SL, TZ, US, UZ
    373  - New geocoding data for country calling code(s):
    374    966 (ar, en), 1 (en)
    375 
    376 Sep 2, 2013: libphonenumber-5.8
    377 * Code changes:
    378  - Renamed ShortNumberUtil to ShortNumberInfo -> the former class is now deprecated and will be
    379    deleted in a later release. At the moment it just delegates to ShortNumberInfo.
    380  - New methods in the ShortNumberInfo API - isCarrierSpecific, singleton interface,
    381    isPossibleShortNumber, isValidShortNumber, getShortNumberCost. Note this is an experimental API
    382    at the moment and subject to change.
    383  - Bug fixes:
    384     -- AsYouTypeFormatting: 3-digit numbers can be formatted as a group where appropriate
    385     -- AsYouTypeFormatting: Countries with an optional national prefix were considered before to
    386        have always entered it, resulting in bugs where numbers without the national prefix were
    387        not properly formatted.
    388     -- Numbers in Chile that overlap with emergency numbers are no longer marked as connecting to
    389        them
    390     -- Not requiring the NDC to be alone for countries where there is no national prefix in strict
    391        grouping when extracting phone numbers
    392 * Metadata changes:
    393  - New alternate formatting data for country calling code(s):
    394    30, 31, 385, 58, 62, 63, 971, 972
    395  - Updated alternate formatting data for country calling code(s): 43, 44, 49
    396  - Moved emergency phone number data to the ShortNumberMetadata.xml file
    397  - Updated phone metadata for region code(s):
    398    AT, EG, ML, NC, NL, SA
    399  - New short number metadata for region code(s):
    400    AR, CL, CO, ES, MX, NC
    401  - Emergency metadata fixes for region code(s):
    402    GA, JM, MH, VE
    403 
    404 Aug 09, 2013: libphonenumber-5.7.2
    405 * Metadata changes:
    406  - New alternate formatting data for country calling code(s):
    407    352, 359, 372, 373, 375, 595, 7, 855
    408  - Updated phone metadata for region code(s):
    409    AR, BF, BH, BR, BY, CH, CM, CN, GE, GW, HN, JM, KH, LT, LU, MU, NP, RO, SO
    410  - New short number metadata for region code(s): BR
    411  - Updated short number metadata for region code(s):
    412    CH, FJ, GB, GG, IM, IT, JE, SH
    413 
    414 Aug 8, 2013: libphonenumber-5.7.1
    415 * Metadata/code changes:
    416  - Change to the way the metadata is built; now only parts of the proto that are relevant will be
    417    generated. This means short-code data won't be generated for the normal protos, and fixed-line
    418    data won't be generated for short-number protos. This cuts the metadata binary size approximately
    419    in half.
    420 
    421 Jul 17, 2013: libphonenumber-5.7
    422 * Code changes:
    423  - Improve phone number extraction recall.
    424  - Add support for loading short number metadata.
    425 
    426 Jul 16, 2013: libphonenumber-5.6.2
    427 * Metadata changes:
    428  - Updated alternate formatting data for country calling code(s): 49, 61
    429  - New metadata for region code(s): TA
    430  - Updated metadata for region code(s):
    431    BF, BH, BI, BJ, BR, CR, EH, GA, GE, GN, GU, IL, IN, IR, KH, KW, KZ, MA, MT,
    432    NA, NE, NL, PH, RO, SH, SO, TK
    433  - New geocoding data for country calling code(s): 47 (en), 82 (ar)
    434  - Updated geocoding data for country calling code(s):
    435    49 (en), 98 (en, fa), 241 (en)
    436 
    437 Jul 12, 2013: libphonenumber-5.6.1
    438 * Code changes:
    439  - Rename all instances of PhoneNumberMetadata to PhoneNumberMetadata for consistency.
    440 
    441 Jun 05, 2013: libphonenumber-5.6
    442 * Code changes:
    443  - Fix for as-you-type-formatting bug affecting countries with no national prefix
    444    formatting rule, such as China.
    445 * Metadata changes:
    446  - New alternate formatting data for country calling code(s): 351
    447  - Updated alternate formatting data for country calling code(s): 49
    448  - Updated metadata for region code(s):
    449    AS, BG, BH, BJ, BL, CD, CI, DE, DZ, EH, FJ, GF, GP, IN, KH, KZ, MA, MD, MF,
    450    ML, MY, NG, PT, PY, TC, TJ, TT
    451 
    452 May 08, 2013: libphonenumber-5.5
    453 * Code changes:
    454  - Changed internal initialization code and made more fields final.
    455    Note that we now throw an exception if an attempt is made to set the
    456    metadata more than once (which should only happen during testing).
    457  - Fix problem with formatNumberForMobileDialing for HU and CL.
    458 * Metadata changes:
    459  - Updated alternate formatting data for country calling code(s): 49
    460  - Updated metadata for region code(s):
    461    AM, BF, BR, CR, DE, MA, MG, MM, SA, TL, UA
    462  - Updated geocoding data for country calling code(s): 374 (am, en, ru)
    463 
    464 Apr 19, 2013: libphonenumber-5.4.2
    465 * Metadata changes:
    466  - Updated metadata for region code(s): BF, GA, IN, KR, MV, PH, SO, UA, US
    467 
    468 Mar 25, 2013: libphonenumber-5.4.1
    469 * Metadata changes:
    470  - Updated metadata for region code(s): BF, BH, CR, EC, IR, MG, PF, TD, TN
    471  - New geocoding data for country calling code(s): 374 (am, ru)
    472  - Updated geocoding data for country calling code(s):
    473    98 (en, fa), 358 (en, se), 374 (en)
    474 
    475 Mar 07, 2013: libphonenumber-5.4
    476 * Code changes:
    477  - Switch formatNumberForMobileDialing to prefer national format to international format when the
    478    number is dialed from the same region the phone number is from.
    479 
    480 * Metadata changes:
    481  - Updated metadata for region code(s):
    482    BF, CD, CN, CZ, GN, IR, JP, KR, KW, LR, NZ, TT, UG, ZW
    483  - New geocoding data for country calling code(s): 82 (cs)
    484  - Updated geocoding data for country calling code(s):
    485    82 (en, fr, ko, zh, zh_Hant), 98 (en, fa), 263 (en)
    486 
    487 Feb 11, 2013: libphonenumber-5.3.2
    488 * Metadata changes:
    489  - Updated metadata for region code(s):
    490    BD, BE, BY, CA, EH, GR, IE, IN, IS, LI, MA, MU, PT, SE, SG, TL
    491  - New geocoding data for country calling code(s):
    492    375 (be, en, ru), 1 (en)
    493 
    494 Jan 25, 2013: libphonenumber-5.3.1
    495 * Metadata changes:
    496  - Updated metadata for region code(s): CN, DK, EH, GN, KH, KW, MA, MY, PA
    497 
    498 Jan 08, 2013: libphonenumber-5.3
    499 * Code changes:
    500  - Handling UAN numbers in Argentina better when dialling them locally from a
    501    mobile
    502 * Metadata changes:
    503  - Updated metadata for region code(s):
    504    BE, BW, CL, CN, CO, EH, KW, MA, ML, NG, PL, SY, ZA, ZM
    505  - New geocoding data for country calling code(s): 32 (en, fr, nl)
    506  - Updated geocoding data for country calling code(s): 27 (en), 86 (en, zh)
    507 
    508 Dec 06, 2012: libphonenumber-5.2.2
    509 * Metadata changes:
    510  - New metadata for region code(s): EH
    511  - Updated metadata for region code(s): BR, CL, CR, IN, MA, PG, PK, RO
    512  - New geocoding data for country calling code(s): 241 (en)
    513 
    514 Nov 26, 2012: libphonenumber-5.2.1
    515 * Metadata changes:
    516  - Updated metadata for region code(s):
    517    AE, AW, BF, CN, DE, JO, KE, KH, LT, MM, MU, NG, RW, SR, TR, VU
    518  - New geocoding data for country calling code(s): 359 (bg, en)
    519 
    520 Oct 10, 2012: libphonenumber-5.2
    521 * Code changes:
    522  - Adds isNumberGeographical() method.
    523  - Adds getRegionCodesForCountryCode() method.
    524  - Fixing issue with getSupportedGlobalNetworkCallingCodes()
    525    [https://github.com/googlei18n/libphonenumber/issues/202]
    526  - Ensures that returned collections are unmodifiable where necessary
    527    [there is a very slight risk that this may break existing users who were relying on being able
    528    to modify these collections, but doing so would be breaking lots of other assumptions that this
    529    library makes - if you need to modify any affected collections you must copy them first]
    530 * Metadata changes:
    531  - Updated metadata for region code(s): DE, GR, HR, OM, SB, ZA
    532  - Removed metadata for region code: AN (Netherlands Antilles)
    533  - Updated geocoding data for country calling code(s): 30 (el, en)
    534 
    535 Sep 27, 2012: libphonenumber-5.1.4
    536 * Metadata changes:
    537  - Updated metadata for region code(s): AU, EC, KH, LB, TN, US
    538 
    539 Sep 17, 2012: libphonenumber-5.1.3
    540 * Metadata changes:
    541  - Updated metadata for region code(s): EG, LA, LB, LI, PY
    542  - Updated metadata for non-geographical calling codes: 800, 808, 888, 979
    543  - Updated geocoding data for country calling code(s): 98 (en), 1 (en)
    544 
    545 Sep 11, 2010: libphonenumber-5.1.2
    546 * Bug fix:
    547  - Fixing regression in AsYouTypeFormatter where it no longer worked for numbers entered in national
    548    format for countries with no national prefix, e.g. Spain.
    549 
    550 Sep 5, 2010: libphonenumber-5.1.1
    551 * Code changes:
    552   - Added better logging/exception handling for catching cases where metadata is invalid/missing.
    553 
    554 Sep 3, 2012: libphonenumber-5.1
    555 * Code changes:
    556  - Inserting a space after the national prefix in the AsYouTypeFormatter when formatting numbers in
    557    national format, if the formatting rules for that country dictate that a space is appropriate.
    558  - Format emergency numbers and short-codes as a block in the AsYouTypeFormatter.
    559 * Metadata changes:
    560  - Updated metadata for region code(s): BF, BG, DZ, GA, IT, JP, KW, PF
    561 
    562 Aug 20, 2012: libphonenumber-5.0.3
    563 * Metadata changes:
    564  - New alternate formatting data for country calling code(s): 43
    565  - Updated metadata for region code(s): AT, BF, JO, NG, RU, SL
    566  - New geocoding data for country calling code(s): 62 (en, id), 98 (fa)
    567 
    568 Aug 07, 2012: libphonenumber-5.0.2
    569 * Metadata changes:
    570  - Updated metadata for region code(s):
    571    BF, CN, DJ, IL, JO, KH, KZ, MA, MT, MV, MY, NC, NG, SD, SK, SN, TL, UZ
    572  - New geocoding data for country calling code(s): 7 (ru), 98 (en)
    573  - Updated geocoding data for country calling code(s): 7 (en)
    574 
    575 July 26th, 2012: libphonenumber-5.0.1
    576 * Metadata changes
    577  - CL, DE ,IN, KR, US
    578  - New geocoding data for country calling codes 40, 57, 66, 82, 91.
    579  - Fixed comments for 353 (IE).
    580 
    581 July 12th, 2012: libphonenumber-5.0
    582 * Code changes:
    583  - Support for alternate formats when finding phone numbers.
    584  - Allowing two-digit numbers to be parsed if they are entered in national-format with no
    585    punctuation
    586 * Metadata changes
    587  - IL, GA
    588 * Other
    589  - Reflowed this file to 100 char width to make it unambiguous as to what the standard should be.
    590 
    591 July 6th, 2012: libphonenumber-4.9.1
    592 * Metadata changes
    593  - AR, BA, BF, CR, DE, EC, ES, KZ, MK, NC, NG, PF, SB, UZ, non-geo entity 882
    594  - Geocoding data updates for country calling codes 54 (AR) and 81 (JP), new data for 234 (NG)
    595 
    596 June 21st, 2012: libphonenumber-4.9
    597 * Bug fix
    598  - formatInOriginalFormat fixed not to add a star sign if it was not present originally.
    599 * Metadata changes
    600  - BF, CZ, ES, KW
    601  - Non-geographical entities with calling code 882 (BebbiCell, Maritime Communications, Oration
    602    Technologies, Telespazio and Thuraya)
    603  - Geocoding data updates for country calling codes 221, 224, 226, 242, 244, 245
    604 * Functionality changes:
    605  - Minimum allowed length for a national significant number (NSN) when parsing changed from 3 to 2.
    606  - Support parsing of RFC3966-formatted strings with an isdn-subaddress or extra parameters
    607    specified.
    608  - Allow soft hyphen to appear in phone numbers (\u00AD)
    609 * Testing changes:
    610  - Add extra unit tests for non-geographical phone number entities
    611  - ExampleNumbersTest testEmergency tests now uses ShortNumberUtil
    612 
    613 June 14th, 2012: libphonenumber-4.8.5
    614 * Metadata update only:
    615  - AC, CR, DE, DK, IL, IN, IS, KH, LI, LR, MA, MD, MK, PA, SA, SG, SS
    616 
    617 June 6th, 2012: libphonenumber-4.8.4
    618 * Metadata update only:
    619  - AE, RO
    620  - Non-geographical entity with calling code 881 (Iridium)
    621 
    622 May 30th, 2012: libphonenumber-4.8.3
    623 * Metadata update only:
    624  - AN, ET, KW, MN, SX, TC, TL
    625 
    626 May 16th, 2012: libphonenumber-4.8.2
    627 * Metadata update only:
    628  - BH, CR, EE, JO, KW, LA, QA, SI, TH
    629  - Non-geographical entity with calling code 878 (VISIONng)
    630 
    631 May 8th, 2012: libphonenumber-4.8.1
    632 * Metadata update only:
    633  - CA, CI, EG, HK, IN, IR, LB, MA, ME, MM
    634  - Non-geographical entity with calling code 870 (Inmarsat)
    635  - Geocoding updates for country calling codes 1 for new area codes
    636 
    637 April 24th, 2012: libphonenumber-4.8
    638 * Functionality changes
    639  - RFC format now outputs a number starting with "tel:"
    640  - Parsing support for numbers in RFC format that contain the country info in the "phone-context"
    641    part
    642  - Support for obtaining area codes for Italy, Vatican City, San Marino
    643 * Metadata changes
    644  - AM, AO, AR, BE, BF, CD, EG, GH, GM, GN, IN, IR, IT, JO, LA, LC, MD, MS, NO, PA, PK, SI, SJ, SO,
    645    SY, TC, TN, UZ, VN, ZW
    646  - Geocoding updates for country calling codes 1, 20, 233, 31, 33, 352, 374, 54, 56, 86
    647 * Refactoring of matching functions, including moving them to PhoneNumberMatcher.
    648 
    649 March 16th, 2012: libphonenumber-4.7
    650 * Bug fixes
    651  - Now return "too long" for input that is longer than 250 chars when parsing
    652 * Metadata changes
    653  - 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,
    654    MK,NA,NE,NZ,SA,SB,SC,SE,SL,SN,UZ
    655 * Refactoring of test classes so that tests requiring the test metadata to be loaded have a common
    656   base class which handles this.
    657 
    658 February 9th, 2012: libphonenumber-4.6
    659 * Bug fixes
    660  - Fix for formatByPattern to enable RFC formatting to work
    661  - Fix for RFC formatting to work even when the international formatting rule starts with
    662    punctuation
    663  - Logging consistency changes - some warnings are no longer printed, others have become only
    664    WARNINGS
    665  - Fix for isValidNumberForRegion potentially throwing a NPE
    666  - Parsing Israeli * numbers written in international format now works
    667  - PhoneNumberMatcher doesn't match timestamps as phone-numbers
    668 * Metadata changes
    669  - Updates for AN, AX, BF, BJ, BR, BS, DJ, FI, IN, LV, MW, RS, SC, VN
    670  - New countries supported: SS (South Sudan), CW (Curaao) and BQ (Bonaire, Sint Eustatius and Saba)
    671 * Refactoring of the private formatting functions in PhoneNumberUtil to ensure names are more
    672   descriptive and to reduce code duplication.
    673 
    674 January 19th, 2012: libphonenumber-4.5
    675 * Code changes
    676  - Support for non-geographical country calling codes (e.g. +800).
    677  - Modify formatInOriginalFormat to not insert/remove/modify digits in the original number passed
    678    in.
    679  - Fix formatOutOfCountryKeepingAlphaChars to not throw a NPE.
    680 
    681 * Metadata changes
    682  - Updates for AR, BH, CI, CN, CR, DE, GA, IL, JO, JP, KE, KZ, LB, LK, LT, MV, MW, MZ, NA, NL, NZ,
    683    PL, RO, SA, SV, TM, UG, US
    684  - New country calling codes: 800, 808, 883, 888, 979
    685  - Geocoding data updates: AR, US
    686 
    687 December 9th, 2011: libphonenumber-4.4
    688 * Code changes
    689  - Support for Voicemail numbers
    690  - Support prefixes "xt" and "xtn" to indicate extensions of phone numbers
    691  - Change formatInOriginalFormat to use raw_input for numbers with incorrect leading zeroes, instead
    692    of all invalid numbers.
    693 
    694 * Metadata changes
    695  - Updates for AR, BD, CH, CI, IL, IR, IS, IT, JP, KW, LR, MM, NG, SA, SC, UZ
    696 
    697 November 24th, 2011: libphonenumber-4.3
    698 * Code changes
    699  - Fix the problems with AYTF crashing for longer numbers entered with +CountryCode, and incorrectly
    700    removing national prefix for some numbers.
    701  - Improve PhoneNumberMatcher to not match numbers ending with '%'.
    702  - Fix formatNumberForMobileDialing to handle Israeli star numbers, Peruvian and Colombian numbers.
    703  - Modify formatInOriginalFormat to use the raw input if we don't have a formatting pattern for a
    704    number.
    705  - Simple offline geocoding function which takes into account the user's region.
    706 
    707 * Metadata changes
    708  - Updates for CR, GN, JP, KE, PL, SG, SR, SX, TH, TK
    709 
    710 November 10th, 2011: libphonenumber-4.2
    711 * Code changes
    712  - Providing an "exact match" isEmergencyNumber method
    713  - Improvement to PhoneNumberMatcher: requires national prefix to be present when matching
    714    national-format numbers, unless matching for a region where it is explicitly marked in the
    715    metadata that they may be omitted. Applies to leniency level VALID and higher.
    716  - Change formatNumberForMobileDialing not to modify the phoneNumber passed in.
    717 
    718 * Metadata changes
    719  - Emergency numbers added for all remaining countries
    720  - Collected data on which numbers we format with a national prefix are commonly written without one
    721    and added this
    722  - Updates for AR, AT, BH, CZ, GR, IR, KM, LT, MX, PT, SE, SO, UG
    723  - Addition of SX (Sint Maarten)
    724 
    725 October 19th, 2011: libphonenumber-4.1
    726 * Code changes
    727  - Update code and metadata for countries with IDD "8~10" to accept phone numbers where the "~" is
    728    omitted.
    729  - Modify formatInOriginalFormat to use raw_input (when present) when the number is considered as
    730    invalid by the library.
    731  - Add ShortNumberUtil to deal with international short phone numbers, such as short codes and
    732    emergency numbers.
    733  - Increase the maximum phone-number length accepted when parsing (now set to
    734    16).
    735 
    736 * Metadata changes
    737  - Updates: BF, BN, CN, DE, DK, DO, FR, IN, KI, KW, MC, MD, ML, PA, QA, SB, UK, WS
    738  - Emergency number information also added to: AE, AF, AL, AM, AR, AT, AU, BA,
    739    BB, BD, BE, BG, BH, BO, BR, BY, CA, CH, CL, CN, CO, CR, CY, CZ, DE, DJ, DK,
    740    DO, DZ, EC, EE, EG, ES, FI, FJ, FO, FR, GB, GE, GF, GH, GI, GL, GR, GT, GY,
    741    HK, HN, HR, HU, ID, IE, IL, IN, IR, IS, IT, JM, JO, JP, KR, KW, KY, KZ, LB,
    742    LK, LT, LU, LV, MA, MC, MD, ME, MK, ML, MM, MN, MO, MT, MU, MV, MX, MY, NG,
    743    NI, NL, NO, NP, OM, PA, PE, PH, PK, PL, PM, PT, PY, QA, RO, RS, RU, RW, SA,
    744    SB, SD, SE, SG, SI, SK, SL, SM, SR, SV, SY, TD, TH, TJ, TM, TN, TR, TT, TW,
    745    UA, UG, US, UY, UZ, VA, VE, VN, VU, ZA, ZM, ZW
    746 
    747 October 6th, 2011: libphonenumber-4.0
    748 * Code changes
    749  - New function formatNumberForMobileDialing, which attempts to format a number in such a way that
    750    the call can be connected from a mobile phone. If this is impossible, for example for numbers
    751    that cannot be internationally dialled, then an empty string is returned.
    752  - Fallback functionality to English for non-CJK languages for geocoding
    753 
    754 * Metadata changes
    755  - Collecting data for emergency numbers
    756  - Updates: AR, AU, BR, CN, CZ, EG, GD, IE, IL, JM, KW, KH, SD, SO, TR, UG, UZ
    757  - Geocoding data changes: AO, AR, AT, BJ, BR, CD, CG, CI, CL, CN, CV, DE, ES,
    758    FR, GR, GW, HU, KM, MR, MZ, NL, PL, PT, SE, ST, SZ
    759 
    760 September 13th, 2011: libphonenumber-3.9
    761 * Code changes
    762  - Enable AsYouTypeFormatter to handle long IDD and NDD.
    763  - Allow the presence of an IDD following a +.
    764  - Fix formatting of phone numbers which contain only 0s in the national number.
    765  - Refactored some code in geocoding including AreaCodeMap and the storage strategies.
    766 
    767 * Metadata changes
    768  - Updates: AM, BE, BH, BJ, BR, BT, BZ, CI, CL, CN, DE, DK, DM, DZ, EC, EG, FJ,
    769    GR, HR, HT, IN, IQ, IS, JM, KE, KG, KH, KR, LA, LB, LR, MA, MD, ML, MO, MX,
    770    MY, NE, NG, PG, PH, PK, PY, QA, SA, SD, SG, SN, TD, TG, TH, TN, TT, UG, YE,
    771    ZA, ZM
    772  - New geocoding data for: AC, CG, CU, CV, EG, ET, FI, FI, FI, GL, JP, KM, MA,
    773    MA, MU, MU, MU, MZ, RS, SH, SH, SL, SO, ST, TG, TG, TG, UG, ZM
    774  - Updated geocoding data for: AR, DE
    775 
    776 August 11th, 2011: libphonenumber-3.8
    777 * Code changes
    778  - Fix to demo to not throw null-ptr exceptions for invalid NANPA numbers
    779  - Fixed AYTF to not accept plus signs in the middle of input
    780  - PhoneNumberMatcher improvements - added STRICT_GROUPING and EXACT_GROUPING levels, numbers
    781    followed/preceded by a currency symbol will not match, multiple numbers separated by phone-number
    782    punctuation will now match. ", " is no longer accepted as an extension symbol when matching, only
    783    when parsing. "x" is only accepted as a carrier code or extension marker, not otherwise.
    784  - Changes to handling of leading zeroes - these will not be silently ignored anymore, but will be
    785    stored as part of the number.
    786  - PhoneNumberOfflineGeocoder - new method to get the description of a number that assumes the
    787    validity of the number has already been checked and will not re-verify it.
    788  - Split geocoding US binary data into multiple files.
    789 
    790 * Metadata changes
    791  - Updates: AR, AT, AU, AZ, BE, BF, BH, BY, CA, CN, CO, CR, HT, HU, IT, KG, KH,
    792    LB, LI, ME, NC, RS, SE, TT, US, VG, ZA
    793  - New geocoding data for: AL, AM, AO, BF, BJ, BW, CD, CI, CZ, DZ, EE, GH, GM,
    794    GN, GR, GW, HU, IS, KE, LK, LS, LT, LU, LV, MD, MG, MR, NA, PE, QN, SD, SK,
    795    SN, SZ, TN, VE, VN, ZA, ZW
    796  - Updated geocoding data for: GB, PT, US
    797  - Revised sorting of geocoding data
    798 
    799 July 5th, 2011
    800 * Code changes
    801  - Refactored AreaCodeMap to minimize binary and memory footprint by using 2 different strategies.
    802  - Refactored BuildMetadataFromXml.java and added unittests.
    803 
    804 * Metadata changes
    805  - Regenerate binaries for all existing area code mapping data with smaller sizes.
    806  - Added city-level area code data mapping for US and Canada.
    807 
    808 June 29th, 2011
    809 * Code changes
    810  - Fixed issue 38, issue 39, issue 41 and issue 43
    811 
    812 * Metadata changes
    813  - Added phone number area mapping files for
    814    - JP in Japanese
    815    - FR in French
    816    - TW in English, Simplified and Traditional Chinese
    817    - RU in English
    818    - IT in English and Italian
    819    - PT in Portuguese
    820    - TR in English and Turkish
    821    - CH in English, German, French and Italian
    822  - Updates: CR, GE, IT, JP, KW, MH, MP, MU, PE, PM, RW, TG, TJ, TK
    823 
    824 June 14th, 2011
    825 * Code changes
    826  - Added PhoneNumberOfflineGeocoder, supporting classes and their unittests.
    827  - Added GenerateAreaCodeData to transform phone number area mapping files from text files to binary
    828    files.
    829  - Modified PhoneNumberParserServlet.java and phonenumberparser.jsp to incorporate
    830    PhoneNumberOfflineGeocoding in the appengine demo.
    831 
    832 * Metadata changes
    833  - Added phone number area mapping files for NANPA countries and GB in English, NL in Dutch, AR, CL
    834    and ES in Spanish, AT and DE in German, SE in Swedish, BR in Portuguese, KR in English, Korean,
    835    Simplified and Traditional Chinese, and CN in Simplified Chinese.
    836 
    837 June 10th, 2011
    838 * Code changes:
    839  - Fixes for PhoneNumberMatcher to be more restrictive in valid mode and not match numbers
    840    surrounded by Latin characters. This ensures, for example, the string abc123456789acg will not be
    841    marked as a phone numbers.
    842  - Enable PhoneNumberUtil to handle all digits, rather than a subset
    843  - Fix for AYTF issue36 and improvement for US AYTF behaviour.
    844 * Metadata changes:
    845  - Updates: BG, EG, ES, GH, PF, SC, SY, VA
    846 
    847 May 24th, 2011
    848 * Code changes:
    849  - Phonenumber now implements Serializable.
    850  - findNumbers doesn't accept numbers with mis-matched brackets as phone-numbers
    851  - An offline phone number geocoder has been added. The current implementation just returns the
    852    region name for the phone number; more detailed geocoding will be added later.
    853 * Metadata changes:
    854  - New countries: GF, KP, NC, PA, PF, PW, PY, SB, SR, TO, UY, VU
    855  - Updates: CY, CZ, ES, GB, GQ, JM, MQ, TN, VI
    856 
    857 May 9th, 2011
    858 * Code changes:
    859  - Fixed potential for a null-ptr exception in getExampleNumber
    860  - Potential speed improvement with replacement of StringBuffer with StringBuilder
    861 * Metadata changes
    862  - Changed way that international formats are specified to make it easier to do so
    863  - New countries: AX, CC, CX, WF
    864  - Updates: AM, AR, AU, AW, CN, CO, CR, DM, EC, ET, FI, FJ, GH, IN, JP, KE, KM,
    865    KN, LR, MD, MQ, MX, NP, PH, SC, SE, SM, SN, SY, UG, US, VC, VI, ZM
    866 
    867 Apr 26th, 2011
    868 * Code changes:
    869  - Improved PhoneNumberMatcher for cases with other numbers before or after the phone number.
    870  - Improved AsYouTypeFormatter not to use formatting rules containing non-formatting characters
    871    (e.g. '*' in Israeli star numbers).
    872 * Metadata changes:
    873  - New countries: FJ, FM, GY, NF, NI, NR, TV.
    874  - Updates: AM, AZ, BF, BW, BZ, CI, CR, GB, GP, HK, JM, KH, LB, LY, MV, PE, PK, SZ, TJ, US.
    875 * Minor documentation updates
    876 
    877 Apr 11th, 2011
    878 * Bug fixes:
    879  - Adding date exclusion pattern in PhoneNumberMatcher.
    880  - Fixing bug with selecting a suitable region for numbers with leading zeros where mutiple regions
    881    for that country code are possible.
    882 * Metadata changes:
    883  - Updates: AG, AI, AS, BB, BM, BS, CA, DM, DO, ET, FO, GD, GE, GU, IN, JM, KN, KY, LC, MN, MP, MR,
    884    MS, NO, PR, TC, TR, TT, US, VC, VG, VI
    885  - New countries: CK, FK, GT, IO, KI, SJ, SV
    886 * Documentation updates and some small refactoring to AsYouTypeFormatter
    887 
    888 Mar 31st, 2011
    889 * New functionality:
    890  - Can parse and format numbers in RFC-3966 format.
    891  - Added isAlphaNumber to check to see if a number is a "vanity" or "alpha" number
    892  - Can format a number made up of alpha-characters in an "out-of-country" format (e.g. 0011 1
    893    800-SIX-FLAG to dial an American alpha-number from Australia).
    894 * Code changes:
    895  - Renamed private vars, private methods and fixed comments to try and differentiate between country
    896    (calling) codes and region codes.
    897  == Non-backwards-compatible API changes: ==
    898  - Renamed getSupportedCountries to getSupportedRegions, as this more accurately reflects that the
    899    library is based around region codes.
    900  - getNationalSignificantNumber is no longer a static method, but is instead an instance method.
    901 * Metadata changes:
    902  - Bug-fixes and updates for AU, AZ, EE, FI, IN, JO, KW, KZ, MV, RU, RR, VA
    903  - New country: ME
    904 
    905 Mar 22nd, 2011
    906 * Metadata changes:
    907  - New mobile-number pattern for AU
    908 
    909 Mar 10th, 2011
    910 * New functionality:
    911  - New function to format a number with the preferred domestic carrier code used when parsing,
    912    falling back to a default calling code otherwise (formatNationalNumberWithPreferredCarrierCode).
    913  - We now store the preferred domestic carrier code used when the user calls parseAndKeepRawInput
    914  - New functionality to extract phone-numbers from text (findNumbers). This is just the first
    915    version - it does not extract ALPHA numbers such as 0800 CALL ME, or numbers where alternate
    916    endings are specified (such as 03-331 6005/6006).
    917 * Code changes:
    918  - Tidying up the test file to use several pre-defined phone number constants
    919  - Fixing several lint errors
    920  - Added javadoc to formatNationalNumberWithCarrierCode
    921  - Fixed bug where a null pointer exception was thrown when getAsYouTypeFormatter was called with an
    922    invalid region code
    923  - Improved AsYouTypeFormatter to deal with countries with variable-length patterns such as LU
    924 * Metadata changes:
    925  - Bug-fixes and updates for the following countries: BF, BO, BR, CL, CO, CR, DK, FO, GE, KR, KW,
    926    LA, LU, MU, SC, SH, TR, VE
    927  - New country: SH
    928 
    929 Mar 10th, 2011
    930 * Code changes:
    931   - releasing the code to run the demo on localhost or appengine.
    932 
    933 Mar 7th, 2011
    934 * Metadata changes:
    935  - Adding support for AC
    936 
    937 Feb 11th, 2011
    938 * Metadata changes:
    939  - Update UAN number ranges for IM and JE.
    940 
    941 Feb 9th, 2011
    942 * Code changes:
    943   - Better isNumberMatch method. This will now recognise numbers starting with a national prefix as
    944     an NSN_MATCH, instead of SHORT_NSN_MATCH.
    945     == Note Non-backwards-compatible API change here! ==
    946       This will no longer throw a NumberParseException - instead we will return NOT_A_NUMBER if one
    947       or other of the numbers provided do not match.
    948   - New number-type UAN now supported in the code. This represents Company Numbers or Universally
    949     Accessible Numbers.
    950 * Metadata changes:
    951   - Bug-fixes and updates for the following countries: AG, AZ, BA, BE, CA, CU, ES, FI, GB, GD, GG,
    952     IE, IL, IM, IN, IR, IT, JE, JP, KR, KW, NG, NZ, PK, PS, PT, RU, SE, SG, SY, US
    953   - New countries: CO, LU, LY, MC, SM
    954   - Addition of "Personal Number" ranges to all NANPA countries
    955 
    956 Jan 31st, 2011
    957 * Code changes:
    958   - Introducing equals() and hashCode() methods for the Phonenumber.PhoneNumber class
    959 
    960 Jan 28th, 2011
    961 * Code changes:
    962   - Fixing critical bug with non-Android-compatible code. isEmpty() was being used and CANON_EQ in
    963     reg-ex matches.
    964 
    965 Jan 20th, 2011
    966 * Code improvements:
    967   - Handle null phone-numbers when parsing by throwing a NumberParseException.
    968   - Handle extension written with an accented "o", as per Spanish, when parsing.
    969   - Handle U+30FC dashes as phone-number punctuation.
    970   - Allow "ZZ" or null regions to be specified for numbers starting with a full-width "+" symbol, or
    971     with other characters (such as whitespace) before the leading +.
    972   - new getLengthOfNationalDestinationCode function
    973 * Metadata changes:
    974   - New types of numbers introduced: UAN (universal or "company" numbers) and short codes. Note that
    975     "generalDesc" patterns do not encompass short-codes.  No code-support for these has been
    976     introduced as of yet. We are also now enabling the collection of data for information such as
    977     area-code-optional, and no-international-dialling ranges.
    978   - Data updates as per ITU notifications/bug fixes for the following countries: AM, BH, CD, CG, CR,
    979     DE, DJ, EE, GB, GN, HU, IE, JO, JP, LB, LR, MA, MK, MN, MR, NA, PG, SC, SG, SO, SZ, VN, ZA, ZW
    980   - Data added for the following countries: BZ, CU, EC, FO, GI, HN, HT, LK, MT, MV, NU, PS, SD
    981   - Indentation fixes in reg-exes for the following countries: BG, GB
    982   - Allow nationalPrefixForParsing to be specified for countries with no national prefix, to handle
    983     possible carrier prefixes
    984 
    985 Jan 3rd, 2011
    986 * Metadata changes:
    987   - Updates to JE
    988   - Updated comments for GB/GG/IM/JE
    989 
    990 November 25th, 2010
    991 * Metadata changes:
    992   - Updates to existing countries: AD, AG, AI, AN, AS, BB, BG, BM, BS, BW, CA, DM, DO, GD, GH, GM,
    993     GU, IN, JM, KN, KY, KZ, LB, LC, MP, MS, PR, SY, TC, TT, TZ, US, VC, VG, VI.
    994   - Reorganize reg-exes for better readability.
    995   - Updated comments.
    996 
    997 October 22nd, 2010
    998 * Metadata changes:
    999   - Updates to existing countries: AE, GB, GG, IM, JE
   1000 
   1001 October 15th, 2010
   1002 * Code improvements:
   1003   - Allowed parsing of numbers that start with "++" or a full-width "+" symbol
   1004   - Allowed reg-exes for national and possible number patterns to have white space in them in the
   1005     source XML file
   1006   - Added a more useful toString method for the phone number proto class
   1007 * Metadata changes:
   1008   - Updates to existing countries: AF, BF, BO, ES, GB, GG, IM, IS, JE, JE, JP, KR, PE, PT, RU, SE,
   1009     TT, ZW
   1010 * Bug fixes:
   1011   - Parsing empty strings with invalid region codes no longer throws a null pointer exception
   1012 
   1013 September 4th, 2010
   1014 * Code improvement:
   1015   - Added new phone number type: pager
   1016 * Metadata change:
   1017   - update to existing country: GG, IM, JE, RS, RU
   1018 * Bug fixes:
   1019   - ArrayOutOfBoundException in AsYouTypeFormatter.getRememberedPosition()
   1020   - AsYouTypeFormatter for UK childline number
   1021 
   1022 September 1st, 2010
   1023 * Bug fix on KZ metadata.
   1024 
   1025 August 17th, 2010
   1026 * Code improvement:
   1027   - Refactored BuildMetadataProtoFromXml.java into BuildMetadataFromXml.java and
   1028     BuildMetadataProtoFromXml.java
   1029   - Added BuildMetadataProtoFromXml.java and JSArrayBuilder.java
   1030   - Refactored CountryCodeToRegionCodeMap and CountryCodeToRegionCodeMapForTesting into separate
   1031     files.
   1032 
   1033 August 16th, 2010
   1034 * Bug fixes
   1035   - AsYouTypeFormatter for formatting Chinese geographical numbers entered in national format.
   1036   - AsYouTypeFormatter for formatting Chinese 400/800 numbers entered in national format.
   1037 * Metadata change:
   1038   - new countries: AM, AN, BH, GL, IS
   1039   - adding national prefix 1 to all NANPA countries.
   1040   - update to existing countries: BF, FR, UK, PK, RE
   1041 
   1042 August 4th, 2010
   1043 * Further improve startup performance
   1044   - Preload no country specific metadata at startup.
   1045   - Stop creating the file containing mapping from country calling code to region code and loading
   1046     it at startup; instead, do the initialization in PhoneNumberUtil.
   1047 
   1048 July 31th, 2010
   1049 
   1050 * Improve startup performance
   1051   - Separate generated metadata binary file to one file per region
   1052   - Preload US at start up, and load other region at the time when needed
   1053   - Create a file containing mapping from country calling code to region code, and load it at
   1054     startup
   1055   - Same change also applied to unittests
   1056 
   1057 July 30th, 2010
   1058 * Metadata change:
   1059   - new country: TL
   1060   - update to existing country: AZ, CN, FR, GH, JO, LA, PG, PK, QA, SZ, UA, VN
   1061 
   1062 * Code improvement
   1063   - China local number formatting for AsYouTypeFormatter
   1064   - improve extension parsing to handle number in the form of +1 (645) 123 1234 ext. 910#
   1065