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