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