java/release_notes.txt

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