java/release_notes.txt

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