java/release_notes.txt

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