Home | History | Annotate | Download | only in java
      1 Mar 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 
     13 Feb 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 
     20 Jan 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 
     24 Jan 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 
     34 Dec 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 
     40 Nov 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 
     46 Oct 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 
     61 Sep 27, 2012: libphonenumber-5.1.4
     62 * Metadata changes:
     63  - Updated metadata for region code(s): AU, EC, KH, LB, TN, US
     64 
     65 Sep 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 
     71 Sep 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 
     76 Sep 5, 2010: libphonenumber-5.1.1
     77 * Code changes:
     78   - Added better logging/exception handling for catching cases where metadata is invalid/missing.
     79 
     80 Sep 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 
     88 Aug 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 
     94 Aug 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 
    101 July 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 
    107 July 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 
    117 July 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 
    122 June 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 
    139 June 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 
    143 June 6th, 2012: libphonenumber-4.8.4
    144 * Metadata update only:
    145  - AE, RO
    146  - Non-geographical entity with calling code 881 (Iridium)
    147 
    148 May 30th, 2012: libphonenumber-4.8.3
    149 * Metadata update only:
    150  - AN, ET, KW, MN, SX, TC, TL
    151 
    152 May 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 
    157 May 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 
    163 April 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 
    175 March 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 
    184 February 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 (Curaao) 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 
    200 January 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 
    213 December 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 
    223 November 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 
    236 November 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 
    251 October 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 
    273 October 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 
    286 September 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 
    302 August 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 
    325 July 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 
    334 June 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 
    350 June 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 
    363 June 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 
    373 May 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 
    383 May 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 
    393 Apr 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 
    403 Apr 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 
    414 Mar 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 
    431 Mar 22nd, 2011
    432 * Metadata changes:
    433  - New mobile-number pattern for AU
    434 
    435 Mar 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 
    455 Mar 10th, 2011
    456 * Code changes:
    457   - releasing the code to run the demo on localhost or appengine.
    458 
    459 Mar 7th, 2011
    460 * Metadata changes:
    461  - Adding support for AC
    462 
    463 Feb 11th, 2011
    464 * Metadata changes:
    465  - Update UAN number ranges for IM and JE.
    466 
    467 Feb 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 
    482 Jan 31st, 2011
    483 * Code changes:
    484   - Introducing equals() and hashCode() methods for the Phonenumber.PhoneNumber class
    485 
    486 Jan 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 
    491 Jan 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 
    511 Jan 3rd, 2011
    512 * Metadata changes:
    513   - Updates to JE
    514   - Updated comments for GB/GG/IM/JE
    515 
    516 November 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 
    523 October 22nd, 2010
    524 * Metadata changes:
    525   - Updates to existing countries: AE, GB, GG, IM, JE
    526 
    527 October 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 
    539 September 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 
    548 September 1st, 2010
    549 * Bug fix on KZ metadata.
    550 
    551 August 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 
    559 August 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 
    568 August 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 
    574 July 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 
    583 July 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