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