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