xref: /aosp_15_r20/external/libphonenumber/release_notes.txt (revision e3ee85ea7a059d2c4cb054859ee23ab42559378c)
1Nov 23, 2016: v7.7.5
2Code changes:
3 - Removing all references to possible_number_pattern other than the proto
4   buffer itself (and derived files, or hand-crafted files based on it.) This
5   information is no longer present in the binary.
6 - Refactored metadata loading and removed synchronization for all kinds of
7   metadata. Clients may experience quicker loading of alternate formats and
8   short number metadata, but no change is required for callers of the library.
9 - Reduced visibility of `public` internal API
10   `PhoneNumberUtil.createInstance(MetadataSource)` to `private`. MetadataSource
11   and all its implementations are non-public so this should not affect public
12   usage of the library.
13Metadata changes:
14 - Updated phone metadata for region code(s):
15   BB, BD, ES, HN, IN, KR, KW, MC, NL, PH, PK, SH, TW, VG, ZW
16 - Updated short number metadata for region code(s):
17   AF, AG, AM, AR, AW, AZ, BD, BM, BQ, BW, CD, CI, CM, CO, CW, DZ, GD, GE, GN,
18   GT, GY, HN, HT, IE, IN, IQ, JM, JO, KE, KG, KH, KW, LV, NO, SG, SV, UY
19 - Updated geocoding data for country calling code(s): 504 (en)
20 - New carrier data for country calling code(s): 886 (en), 1284 (en)
21 - Updated carrier data for country calling code(s): 63 (en), 92 (en)
22
23Nov 09, 2016: v7.7.4
24GitHub project changes:
25 - Changed tag to vX.Y.Z from libphonenumber-X.Y.Z; this may affect ports and
26   derived projects.
27Metadata structure changes in XML file:
28 - Mobile and Fixed-Line blocks are no longer assumed to inherit missing data
29   from the GeneralDesc, but are treated like every other phone number type.
30   This means that for the non-geographical country codes, like +800, the
31   example number has been moved from generalDesc to the relevant number types,
32   and the code in getExampleNumberForNonGeoEntity has been changed to look at
33   these sub-types for an example number.
34   This also means that the "NA" and "-1" blocks present in the metadata to
35   indicate that no mobile or fixed-line numbers appear for the entity have been
36   removed.
37   There should no longer be an exampleNumber at the generalDesc level, but it
38   should be present at every PhoneNumberDesc with data.
39Code changes:
40 - Using new possibleLengthInfo to decide whether a short number is the right
41   length or not. This could result in more specific results; whereas before, a
42   number from length 3 to length 6 may have been deemed possible, now we may
43   exclude a number of length 5.
44 - Add hash (#) as a diallable character. Numbers with # in them will no longer
45   have formatting applied in formatInOriginalFormat, and
46   normalizeDiallableCharsOnly now retains the # symbol.
47 - getExampleNumberForNonGeoEntity has been changed to look at the specific
48   number types, not just the generalDesc, for the example numbers; this is a
49   necessary change after the metadata structure change detailed above.
50Metadata changes:
51 - Updated phone metadata for region code(s): AD, AE, IN, IR, MU, MV, NG, PG
52 - Updated short number metadata for region code(s): NL, SN
53 - New geocoding data for country calling code(s):
54   960 (en), 1249 (en), 1343 (en), 1579 (en), 1581 (en)
55 - Updated geocoding data for country calling code(s):
56   1782 (en), 1867 (en), 1902 (en)
57 - Updated carrier data for country calling code(s):
58   91 (en), 234 (en), 971 (en)
59
60Oct 26, 2016: libphonenumber-7.7.3
61Internal changes:
62 - Fixed Phonemetadata.java not to merge from a NumberFormat's unset bool
63   national_prefix_optional_when_formatting.
64 - Added MetadataFilter, an internal API which is under development and subject
65   to backwards-incompatible changes without notice or guarantees.
66Metadata changes:
67 - Updated phone metadata for region code(s):
68   882, AG, AI, AS, BB, BM, BR, BS, CA, DM, DO, GD, GU, HU, IN, JM, KN, KY, KZ,
69   LC, MP, MS, PR, SX, TC, TR, TT, UG, US, VC, VG, VI
70 - Updated short number metadata for region code(s): UY
71 - New geocoding data for country calling code(s): 1463 (en), 358 (sv)
72 - Removed geocoding data for country calling code(s): 358 (se)
73 - Updated geocoding data for country calling code(s): 7 (en, ru)
74 - Updated carrier data for country calling code(s):
75   91 (en), 256 (en), 1876 (en)
76
77Oct 06, 2016: libphonenumber-7.7.2
78Code changes:
79 - Stop setting empty preferred_domestic_carrier_code, and if we are passed such
80   a number then treat the empty field as if unset.
81Metadata changes:
82 - Updated phone metadata for region code(s): CL, FR, KE, MU, NG
83 - Updated short number metadata for region code(s):
84   EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, OM, PA, PE, PF, PG, PH,
85   PK, PL, PM, PR, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG,
86   SH, SI, SJ, SK, SL, SM, SN, SO, SR, ST, SV, SX, SY, SZ, TC, TD, TG, TH, TJ,
87   TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, US, UY, UZ, VA, VC, VE, VG, VI,
88   VN, VU, WF, WS, YE, YT, ZA, ZM, ZW
89 - Updated geocoding data for country calling code(s): 56 (en, es)
90 - Updated carrier data for country calling code(s):
91   230 (en), 234 (en), 254 (en)
92
93Sep 27, 2016: libphonenumber-7.7.1
94Build changes:
95 - OSGi support added to Manifest information when building jar (#1300)
96 - BuildMetadataJsonFromXml changed to output possible lengths for JS build
97 - Fix geocoding file generation to handle language codes that are not just
98   two letters long properly and to process filenames in the same order.
99Code changes:
100 - Switching the internal implementation of isPossible and related functions
101   to use the new possibleLengths metadata. This affects a lot of countries,
102   making isPossible more restrictive as more precise data is available. It
103   also affects parsing ambiguous and invalid numbers, as we decide whether
104   to strip a possible national prefix (1) or country code based on the length
105   of the number and whether it is possible before or after this.
106 - Formatting, naming (LOGGER -> logger) and comment tweaks to follow style
107   guide
108 - Removal of unneeded canBeGeocoded method in the
109   PhoneNumberToTimeZonesMapper.java, using phoneNumberUtil instead
110Metadata changes:
111 - Updated phone metadata for region code(s):
112   800, 808, 870, 878, 881, 882, 883, 888, 979, AG, AM, BD, BF, CL, CO, EC, ET,
113   GB, GG, GH, IN, LR, MD, MQ, SH, SN, TA, TH, TR
114 - Updated short number metadata for region code(s):
115   AC, AD, AE, AF, AG, AI, AL, AM, AO, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD,
116   BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BW, BY, BZ, CA, CC,
117   CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ,
118   DK, DM, DO, DZ, MD
119 - New carrier data for country calling code(s): 593 (en)
120 - Updated carrier data for country calling code(s):
121   49 (en), 56 (en), 66 (en), 90 (en), 91 (en), 226 (en), 231 (en), 373 (en),
122   852 (zh_Hant)
123
124Sep 19, 2016: libphonenumber-7.7.0
125Code changes:
126 - Removed the dependency on protobuf (protobuf-javanano) from the Java library,
127   resurrecting
128   java/libphonenumber/src/com/google/i18n/phonenumbers/Phonemetadata.java
129   which was present until libphonenumber-7.1.1.
130   Does not affect the C++ or JavaScript libraries.
131
132Sep 07, 2016: libphonenumber-7.6.1
133Code changes:
134 - Phonemetadata.java has two more fields to represent possible lengths of phone
135   numbers. Changed BuildMetadataFromXml (and the resultant jar) to alter the way
136   that metadata about possible-lengths information is consumed when constructing
137   metadata to populate these.
138   Discussion list email:
139   https://groups.google.com/forum/#!topic/libphonenumber-discuss/75TOpTFVi08
140Metadata changes:
141 - Updated phone metadata for region code(s):
142   AG, AM, AX, BY, CD, FI, IN, KR, MA, NA, NL, PK, SY
143 - Updated short number metadata for region code(s): BR, GB, NL, NZ
144 - New geocoding data for country calling code(s):
145   82 (pl, pt, ro, ru, sl, sr, uk, vi)
146 - Updated carrier data for country calling code(s):
147   27 (en), 91 (en), 243 (en), 963 (en)
148
149Aug 24, 2016: libphonenumber-7.6.0
150Code changes:
151 - Refactored metadata loading and closed all streams after loading.
152 - Made isNumberGeographical public, and changed the geocoder to
153   use this when checking whether to give a detailed answer or country-level
154   only.
155Build changes:
156 - Use protobuf-javanano 3.0.0-alpha-7 from Maven Central.
157Metadata changes:
158 - Updated phone metadata for region code(s): EH, ET, JM, MA, SK, SN, SY, ZM
159 - Updated short number metadata for region code(s): ZA
160 - Updated geocoding data for country calling code(s): 212 (en)
161 - New carrier data for country calling code(s):
162   86 (zh, zh_Hant), 852 (zh, zh_Hant), 963 (en)
163 - Updated carrier data for country calling code(s):
164   86 (en), 212 (en), 251 (en), 421 (en)
165 - Deleted unsupported SingleFilePhoneNumberMetadataProto
166
167Aug 10, 2016: libphonenumber-7.5.2
168Metadata changes:
169 - Updated phone metadata for region code(s): CO, IN, ME
170 - Updated short number metadata for region code(s): IN
171 - New carrier data for country calling code(s): 382 (en)
172 - Updated carrier data for country calling code(s): 91 (en)
173
174Jul 27, 2016: libphonenumber-7.5.1
175Metadata changes:
176 - Updated alternate formatting data for country calling code(s): 595
177 - Updated phone metadata for region code(s): BD, BG, CI, IN, PY, TJ
178 - Updated short number metadata for region code(s): IN
179 - New geocoding data for country calling code(s):
180   82 (bg, ca, el, es, fi, hi, hu, iw, ja, tr)
181 - Updated geocoding data for country calling code(s): 44 (en)
182 - New carrier data for country calling code(s): 374 (ru)
183 - Updated carrier data for country calling code(s):
184   91 (en), 374 (en), 992 (en)
185
186Jul 22, 2016: libphonenumber-7.5.0
187Code changes:
188 - Simplify concurrent metadata loading in MultiFileMetadataSourceImpl and
189   reduce points of contention.
190
191Jul 14, 2016: libphonenumber-7.4.5
192Metadata changes:
193 - Updated phone metadata for region code(s): CN, HN, IN, KW, LV, TC
194 - Updated short number metadata for region code(s): AE, BR, GB, ZA
195 - New geocoding data for country calling code(s): 93 (fa), 992 (en)
196 - Updated geocoding data for country calling code(s):
197   91 (en), 98 (en, fa), 371 (en), 504 (en), 1 (en)
198 - Updated carrier data for country calling code(s): 91 (en)
199
200Jun 29, 2016: libphonenumber-7.4.4
201Metadata changes:
202 - Updated phone metadata for region code(s): AZ, BH, HN, IN, US
203 - Updated short number metadata for region code(s): BR, IN, SK
204 - New geocoding data for country calling code(s): 994 (en),
205 - Updated geocoding data for country calling code(s): 504 (en), 1 (en)
206 - Updated carrier data for country calling code(s):
207   91 (en), 973 (en), 994 (en)
208
209Jun 15, 2016: libphonenumber-7.4.3
210Metadata changes:
211 - Updated phone metadata for region code(s):
212   HK, HN, IN, KN, KW, SK, SN, TH, TZ
213 - Updated short number metadata for region code(s): AR, NO
214 - New geocoding data for country calling code(s): 93 (en), 504 (en)
215 - New carrier data for country calling code(s): 93 (fa), 98 (fa)
216 - Updated carrier data for country calling code(s):
217   66 (en), 91 (en), 255 (en), 421 (en)
218
219Jun 01, 2016: libphonenumber-7.4.2
220Code changes:
221 - Make C++ code forward compatible with an upcoming RE2 change.
222Metadata changes:
223 - Updated phone metadata for region code(s): AE, BZ, GU, IN, KR
224 - Updated short number metadata for region code(s): BR
225 - New geocoding data for country calling code(s): 501 (en)
226 - Updated carrier data for country calling code(s):
227   91 (en), 971 (en), 1671 (en)
228
229May 18, 2016: libphonenumber-7.4.1
230Metadata changes:
231 - Updated phone metadata for region code(s): FR, IL, KR
232 - Updated carrier data for country calling code(s): 972 (en)
233
234May 11, 2016: libphonenumber-7.4.0
235Maven changes:
236 - Repackage protobuf runtime dependency to prevent conflicts with clients'
237   protobuf dependencies. Backwards-compatible, so no changes needed for clients
238   who could use the previous release, but enables those with their own protobuf
239   dependencies to use this and future releases without workarounds.
240
241May 03, 2016: libphonenumber-7.3.2
242Metadata changes:
243 - Updated phone metadata for region code(s):
244   AU, BR, ET, IN, KH, ML, NO, SB, TJ, US
245 - Updated short number metadata for region code(s): CA, ML, US
246 - New geocoding data for country calling code(s): 223 (en)
247 - Updated geocoding data for country calling code(s):
248   27 (en), 55 (en, pt), 1 (en)
249 - Updated carrier data for country calling code(s):
250   61 (en), 91 (en), 223 (en), 251 (en), 677 (en), 992 (en)
251
252Apr 20, 2016: libphonenumber-7.3.1
253Metadata changes:
254 - Updated phone metadata for region code(s): DE, DJ, IL, IN, KH
255 - Updated short number metadata for region code(s): BR
256 - Updated carrier data for country calling code(s):
257   91 (en), 855 (en), 972 (en)
258
259Apr 05, 2016: libphonenumber-7.3.0
260Code changes:
261 - Added java/pending_code_changes.txt for contributors to track code changes
262   between releases.
263 - Reduced minimum required version of cmake to 2.8.
264 - Added cmake installation instructions for Mac.
265 - Added getExampleNumberForType that doesn't take in a region, and
266   getInvalidExampleNumber
267 - Improvements to javadoc for parse method
268 - Update isNumberGeographical to return true for geographical mobile numbers.
269Metadata changes:
270 - Updated phone metadata for region code(s):
271   BJ, BZ, CI, ET, GQ, KE, KW, ML, NO, OM, VN
272 - Updated short number metadata for region code(s): KE
273 - Updated geocoding data for country calling code(s):
274   84 (en), 251 (en), 254 (en)
275 - Updated carrier data for country calling code(s):
276   84 (en), 225 (en), 229 (en), 254 (en), 968 (en)
277
278Mar 21, 2016: libphonenumber-7.2.8
279Metadata changes:
280 - Updated phone metadata for region code(s): CL, CN, FO, KE, SE, SO
281 - Updated short number metadata for region code(s): FO
282 - Updated geocoding data for country calling code(s): 86 (en, zh)
283 - Updated carrier data for country calling code(s):
284   86 (en), 252 (en), 254 (en)
285
286Mar 09, 2016: libphonenumber-7.2.7
287Code changes:
288 - Update nationalPrefixOptionalWhenFormatting documentation.
289Metadata changes:
290 - Updated phone metadata for region code(s): CN, IN, MO, TK
291 - Updated short number metadata for region code(s): FR
292 - Updated carrier data for country calling code(s): 853 (en)
293 - Updated / refreshed time zone meta data.
294
295Feb 25, 2016: libphonenumber-7.2.6
296Metadata changes:
297 - Updated phone metadata for region code(s): DJ, MA, NA, US
298 - Updated short number metadata for region code(s): KR
299 - New geocoding data for country calling code(s): 1380 (en)
300 - Updated geocoding data for country calling code(s): 212 (en)
301
302Feb 10, 2016: libphonenumber-7.2.5
303Code changes:
304 - Fix two places in demo where NPEs can occur on bad input.
305 - Fix an IllegalStateException when getMetadataForNonGeographicalRegion is
306   called with a country calling code which isn't a non-geographic entity.
307Metadata changes:
308 - Updated phone metadata for region code(s):
309   AG, AI, AS, BB, BM, BS, CA, DM, DO, ET, GD, GU, JM, KN, KY, LC, MP, MS, PR,
310   SE, SK, SX, TC, TT, US, VC, VG, VI
311 - Updated geocoding data for country calling code(s): 46 (en)
312 - Updated carrier data for country calling code(s): 251 (en)
313
314Jan 28, 2016: libphonenumber-7.2.4
315 - First release to automatically remove obsolete geocoding files
316Metadata changes:
317 - Updated phone metadata for region code(s):
318   BW, CA, CI, CK, GM, IN, NA, NG, PG, TD, TM
319 - Updated short number metadata for region code(s): PT
320 - New geocoding data for country calling code(s): 1825 (en)
321 - Removed geocoding data for country calling code(s):
322   1726 (en), 1730 (en), 1838 (en), 1851 (en), 1888 (en), 225 (fr), 242 (fr),
323   269 (fr), 238(pt), 55 (pt)
324 - Updated carrier data for country calling code(s):
325   91 (en), 225 (en), 234 (en), 235 (en), 675 (en), 993 (en)
326
327Jan 08, 2016: libphonenumber-7.2.3
328Backwards-incompatible code changes:
329 - Removed deprecated ShortNumberUtil.java
330Other code changes:
331 - Updated the demo:
332   added short number support;
333   added permalink;
334   added direct link to file an issue
335Metadata changes:
336 - Updated phone metadata for region code(s):
337   AU, BR, CC, CR, CW, CX, ET, HN, KR, SI, TV, WF
338 - Updated short number metadata for region code(s): FR, HR, HU, IT, KR, LV, TV
339 - New geocoding data for country calling code(s): 688 (en)
340 - Updated carrier data for country calling code(s):
341   61 (en), 251 (en), 506 (en), 599 (en)
342
343Dec 15, 2015: libphonenumber-7.2.2
344Metadata changes:
345 - Updated phone metadata for region code(s):
346   AT, BD, BR, CC, CX, CY, FI, ID, IS, KI, MM, TN, VC
347 - Updated short number metadata for region code(s):
348   AT, BG, CY, CZ, DE, DK, EE, FI, GB, GR, ID, IE, IS, LT, LU, MT, NL, PL, RO,
349   SI, SK
350 - New geocoding data for country calling code(s): 95 (en)
351 - Updated carrier data for country calling code(s):
352   216 (en), 354 (en), 357 (en), 686 (en)
353
354Nov 11, 2015: libphonenumber-7.2.1
355 - Fix to libphonenumber-7.2.0
356Metadata changes: None
357
358Nov 10, 2015: libphonenumber-7.2.0
359* Broken, do not use *
360Code changes:
361 - Phonemetadata now generated as nanoproto
362Metadata changes:
363 - Updated phone metadata for region code(s):
364   BI, BT, IL, MN, MO, NP, RU, SK, VG
365 - Updated short number metadata for region code(s): BT, DK
366 - New geocoding data for country calling code(s): 972 (en), 975 (en)
367 - New carrier data for country calling code(s): 853 (en)
368 - Updated carrier data for country calling code(s):
369   45 (en), 257 (en), 421 (en), 964 (en), 972 (en), 975 (en), 976 (en)
370 - Updated / refreshed time zone meta data.
371
372Oct 29, 2015: libphonenumber-7.1.1
373Metadata changes:
374 - Updated phone metadata for region code(s):
375   AT, BB, BR, GW, ID, MD, OM, SO, TT
376 - Updated short number metadata for region code(s): BB, NO
377 - New geocoding data for country calling code(s): 968 (en)
378 - Updated geocoding data for country calling code(s): 245 (en, pt)
379 - Updated carrier data for country calling code(s):
380   62 (en), 245 (en), 252 (en), 373 (en), 968 (en), 1246 (en)
381
382Oct 08, 2015: libphonenumber-7.1.0
383API changes:
384 - New MetadataSource implementation that reads from a single metadata file with
385   all regions' phone number metadata.
386Metadata changes:
387 - Updated phone metadata for region code(s): BR, BS, HT, IR, KW, MC, PA, VU
388 - Updated carrier data for country calling code(s):
389   98 (en), 678 (en), 880 (en)
390
391Sep 16, 2015: libphonenumber-7.0.11
392Metadata changes:
393 - Updated phone metadata for region code(s):
394   IN, KE, LR, MM, MR, NA, NE, PT, RO, SO, TZ, US
395 - New short number metadata for region code(s): CF, CG, ER, KP, NE, SO
396 - Updated short number metadata for region code(s): CD, NO, PT
397 - New geocoding data for country calling code(s): 1854 (en)
398 - Updated geocoding data for country calling code(s): 264 (en)
399 - Updated carrier data for country calling code(s):
400   40 (en), 91 (en), 95 (en), 227 (en), 231 (en), 252 (en), 254 (en), 255 (en),
401   509 (en)
402
403Aug 31, 2015: libphonenumber-7.0.10
404Metadata changes:
405 - Updated phone metadata for region code(s):
406   AU, BY, CR, DZ, EH, ES, HK, HT, IN, JO, MN, MU, ST, TD, TT, ZW
407 - Updated short number metadata for region code(s): HK, KR
408 - Updated geocoding data for country calling code(s): 263 (en)
409 - New carrier data for country calling code(s): 509 (en), 976 (en)
410 - Updated carrier data for country calling code(s):
411   41 (en), 61 (en), 91 (en), 230 (en), 235 (en), 239 (en)
412
413Aug 03, 2015: libphonenumber-7.0.9
414Metadata changes:
415 - Updated phone metadata for region code(s): AR, IN, MX, PL, SZ, YT, ZW
416 - Updated short number metadata for region code(s): MX, ZW
417 - Updated carrier data for country calling code(s): 91 (en), 263 (en)
418
419Jul 14, 2015: libphonenumber-7.0.8
420Metadata changes:
421 - Updated phone metadata for region code(s):
422   AC, BS, BW, CL, DE, DZ, HN, HR, IL, IN, IT, JO, KY, MA, NP, PL, SH, SL, TM,
423   UA, VA
424 - Updated short number metadata for region code(s): HR
425 - Updated geocoding data for country calling code(s): 56 (en, es)
426 - Updated carrier data for country calling code(s):
427   49 (en), 212 (en), 232 (en), 267 (en), 380 (en), 385 (en), 962 (en),
428   972 (en), 977 (en), 993 (en)
429- Updated / refreshed time zone meta data.
430
431Jun 24, 2015: libphonenumber-7.0.7
432Metadata changes:
433 - Updated phone metadata for region code(s):
434   AC, BF, BG, CG, CM, FR, IL, IN, JP, KW, LB, LI, SB, SD, SH, TT
435 - Updated short number metadata for region code(s): GY, SB
436 - New geocoding data for country calling code(s): 592 (en)
437 - Updated geocoding data for country calling code(s):
438   86 (en, zh), 226 (en), 290 (en, fr)
439 - New carrier data for country calling code(s): 592 (en), 689 (en)
440 - Updated carrier data for country calling code(s):
441   7 (en), 60 (en), 91 (en), 237 (en), 242 (en), 249 (en), 359 (en), 961 (en),
442   1868 (en)
443- Updated / refreshed time zone meta data.
444
445May 29, 2015: libphonenumber-7.0.6
446Metadata changes:
447 - Updated phone metadata for region code(s):
448   BB, BR, CR, ID, IL, JO, KW, LK, LU, MD, MM, MV, MY, PH, PK, SC, SE
449 - Updated short number metadata for region code(s): BE, LK, US
450 - Updated carrier data for country calling code(s):
451   60 (en), 63 (en), 92 (en), 94 (en), 95 (en), 248 (en), 373 (en), 960 (en),
452   972 (en), 1246 (en)
453
454Apr 24, 2015: libphonenumber-7.0.5
455* Metadata changes:
456 - Updated phone metadata for region code(s):
457   AF, AS, BD, BE, CA, CI, ID, IN, JM, KH, LI, LU, MU, NE, PL
458 - Updated short number metadata for region code(s): BE, LI
459 - Updated geocoding data for country calling code(s):
460   62 (en), 86 (en, zh), 358 (en, fi, se)
461 - Updated carrier data for country calling code(s):
462   32 (en), 93 (en), 225 (en), 227 (en), 855 (en), 1684 (en), 1876 (en)
463
464Mar 25, 2015: libphonenumber-7.0.4
465* Metadata changes:
466 - Updated phone metadata for region code(s): CA, HU, IL, JO, LU, SG, SL, US
467 - Updated short number metadata for region code(s): BI
468 - New geocoding data for country calling code(s):
469   1220 (en), 1628 (en), 1629 (en)
470 - Updated carrier data for country calling code(s):
471   65 (en), 232 (en), 972 (en)
472
473Mar 02, 2015: libphonenumber-7.0.3
474* Metadata changes:
475 - Updated phone metadata for region code(s):
476   AR, BH, BY, CI, CN, GH, KR, KW, LU, ME, NZ, SB, WS
477 - New geocoding data for country calling code(s): 64 (en)
478 - Updated geocoding data for country calling code(s):
479   86 (en, zh), 1418 (en), 1438 (en), 1450 (en), 1514 (en), 1819 (en)
480 - Updated carrier data for country calling code(s):
481   225 (en), 233 (en), 677 (en), 973 (en)
482
483Jan 09, 2015: libphonenumber-7.0.2
484* Metadata changes:
485 - Updated phone metadata for region code(s):
486   BD, BH, EH, GH, IN, JM, LU, MA, MY, NF, NG, PK, SB, TT, TZ
487 - Updated geocoding data for country calling code(s): 91 (en), 352 (en, fr)
488 - New carrier data for country calling code(s): 1876 (en)
489 - Updated carrier data for country calling code(s):
490   60 (en), 91 (en), 92 (en), 212 (en), 233 (en), 234 (en), 352 (en), 677 (en)
491
492Nov 25, 2014: libphonenumber-7.0.1
493* Metadata changes:
494 - New alternate formatting data for country calling code(s): 676
495 - Updated phone metadata for region code(s):
496   BI, CM, ID, IR, KR, LA, NP, TG, TH, TO
497 - New geocoding data for country calling code(s): 237 (en)
498 - Updated geocoding data for country calling code(s): 98 (en, fa)
499 - Updated carrier data for country calling code(s):
500   237 (en), 257 (en), 856 (en), 977 (en)
501
502Oct 29, 2014: libphonenumber-7.0
503* Code changes:
504 - New APIs for ShortNumberInfo. The old APIs have been deprecated and will be
505   removed in an upcoming release.
506* Metadata changes:
507 - Updated phone metadata for region code(s):
508   AR, AU, CC, CI, CX, DZ, EE, IN, KZ, MC, SB, TJ, TT
509 - Updated short number metadata for region code(s): MC
510 - Updated geocoding data for country calling code(s): 34 (en, es), 54 (en)
511 - Updated carrier data for country calling code(s):
512   7 (en), 61 (en), 91 (en), 225 (en), 677 (en), 967 (en), 992 (en), 1868 (en)
513
514Oct 13, 2014: libphonenumber-6.3.1
515* Metadata changes:
516 - Updated phone metadata for region code(s):
517   AC, AU, CR, DE, IL, MR, NO, SA, SR, UG
518 - Updated short number metadata for region code(s): CR
519 - Updated carrier data for country calling code(s):
520   61 (en), 256 (en), 506 (en), 597 (en), 966 (en), 972 (en)
521
522Sep 25, 2014: libphonenumber-6.3
523* Code changes:
524  - Changing the offline geocoder to not return any country at all if the number
525    could belong to multiple countries
526  - Removing obsolete code that treated countries with no metadata as valid.
527* Metadata changes:
528 - New alternate formatting data for country calling code(s): 54, 91
529 - Updated phone metadata for region code(s):
530   AM, AR, BR, CA, CL, IL, IN, IR, IS, KE, NI, PF, SB, SN, TH, TN, US
531 - New geocoding data for country calling code(s):
532   1782 (en), 1929 (en), 1930 (en), 1938 (en)
533 - Updated geocoding data for country calling code(s): 98 (en, fa)
534 - New carrier data for country calling code(s): 354 (en)
535 - Updated carrier data for country calling code(s):
536   27 (en), 56 (en), 66 (en), 91 (en), 92 (en), 98 (en), 216 (en), 221 (en),
537   254 (en), 374 (en), 505 (en), 677 (en), 972 (en)
538
539Aug 21, 2014: libphonenumber-6.2.2
540* Metadata changes:
541 - Updated phone metadata for region code(s): BN, CL, CO, DK, IN, SB, SO
542 - Updated short number metadata for region code(s): FR, SA, US
543 - Updated carrier data for country calling code(s):
544   27 (en), 57 (en), 91 (en), 252 (en), 677 (en)
545
546Jul 28, 2014: libphonenumber-6.2.1
547* Metadata changes:
548 - Updated phone metadata for region code(s): BW, LB, MD, PA, PF, VI, ZM
549 - New carrier data for country calling code(s): 507 (en), 961 (en)
550 - Updated carrier data for country calling code(s): 267 (en), 373 (en)
551
552Jun 30, 2014: libphonenumber-6.2
553* Code changes:
554 - Better exclusion of dates when matching phone numbers from text.
555 - Handle phone input in RFC3966 with missing tel: prefix
556
557* Metadata changes:
558 - New alternate formatting data for country calling code(s): 95
559 - Updated phone metadata for region code(s):
560   AF, CN, EH, FJ, IN, JP, KE, KG, KW, MA, MM, PG, PK, SN, SO
561 - New short number metadata for region code(s): SN
562 - Updated short number metadata for region code(s): FR, KE
563 - Updated geocoding data for country calling code(s): 254 (en)
564 - New carrier data for country calling code(s): 95 (en)
565 - Updated carrier data for country calling code(s):
566   92 (en), 93 (en), 212 (en), 221 (en), 254 (en), 675 (en), 679 (en), 965 (en),
567   996 (en)
568
569Jun 06, 2014: libphonenumber-6.1.1
570* Metadata changes:
571 - Updated phone metadata for region code(s):
572   AF, AG, AI, AS, BB, BF, BM, BS, CA, CN, CR, DM, DO, DZ, FR, GD, GU, IN, JM,
573   KH, KN, KW, KY, LC, MN, MP, MS, NG, NI, PH, PR, SX, TC, TT, US, VC, VG, VI
574 - Updated short number metadata for region code(s): AL
575 - New geocoding data for country calling code(s): 1346 (en), 1959 (en)
576 - Updated geocoding data for country calling code(s):
577   33 (en, fr), 352 (de, en, fr), 355 (en)
578 - New carrier data for country calling code(s): 505 (en)
579 - Updated carrier data for country calling code(s):
580   63 (en), 91 (en), 93 (en), 234 (en)
581
582May 08, 2014: libphonenumber-6.1
583* Code changes:
584 - Adding MetadataLoader support to allow custom metadata loading from
585   alternative sources (should have no visible impact to users).
586 - Fixing bug where digits could be lost in as-you-type formatting and
587   formatting patterns incorrectly applied.
588
589* Metadata changes:
590 - Updated phone metadata for region code(s):
591   AR, BF, BR, BS, CL, CN, CO, CR, DE, DM, EC, EG, FR, GA, GD, GH, HU, ID, IL,
592   IN, JP, KH, KI, KN, LA, LC, LR, ML, MU, MX, MZ, NA, NE, PF, PL, RU, SM, TH,
593   TW, UZ, VA, VC
594 - Updated short number metadata for region code(s): BI, CR, PL, TH
595 - New geocoding data for country calling code(s): 32 (de), 1242 (en)
596 - Updated geocoding data for country calling code(s):
597   32 (en, nl), 55 (en), 56 (en, es), 86 (en, zh)
598 - New carrier data for country calling code(s):
599   1758 (en), 1784 (en), 1869 (en)
600 - Updated carrier data for country calling code(s):
601   66 (en), 86 (en), 227 (en), 231 (en), 233 (en), 258 (en), 1473 (en),
602   1767 (en)
603
604Feb 25, 2014: libphonenumber-6.0
605* Code changes:
606 - Better support for detecting phone numbers in text that are beside each other
607 - Change to how Japanese numbers beginning with "00" are modelled, with the
608   side-effect that the maximum possible number length has been extended by 1.
609 - Handle StringIndexOutOfBoundsException in the AsYouTypeFormatter when the
610   national prefix that was extracted was not found in the prefix. This affected
611   countries with very long carrier codes, such as Korea.
612 - Removal of some of the author attributions - contributions to be tracked in
613   CONTRIBUTORS file.
614* Metadata changes:
615 - Updated phone metadata for region code(s): AS, BR, KW, LU
616 - New carrier data for country calling code(s): 1684 (en)
617 - Updated carrier data for country calling code(s): 352 (en)
618
619Feb 07, 2014: libphonenumber-5.9.4
620* Metadata changes:
621 - Updated phone metadata for region code(s):
622   883, BF, BJ, BW, CL, CR, DZ, FR, GD, IN, JP, MD, NG, NZ, PK, PL, SY, UY, VU
623 - Updated short number metadata for region code(s): LV, MD
624 - New carrier data for country calling code(s): 373 (en), 1473 (en)
625 - Updated carrier data for country calling code(s):
626   48 (en), 49 (en), 91 (en), 92 (en), 213 (en), 226 (en), 229 (en), 234 (en),
627   267 (en), 389 (en), 506 (en), 598 (en)
628
629Jan 21, 2014: libphonenumber-5.9.3
630* Metadata changes:
631 - Updated phone metadata for region code(s):
632   BF, BH, BR, CN, GR, IN, MY, PA, TN, US
633 - Updated short number metadata for region code(s): CN
634 - New geocoding data for country calling code(s): 1364 (en), 1725 (en)
635 - Updated geocoding data for country calling code(s): 86 (en)
636 - Updated carrier data for country calling code(s):
637   55 (en), 226 (en), 973 (en)
638
639Dec 20, 2013: libphonenumber-5.9.2
640* Metadata changes:
641 - New alternate formatting data for country calling code(s): 255, 27, 381, 506
642 - Updated alternate formatting data for country calling code(s): 43
643 - Updated phone metadata for region code(s):
644   AG, AI, AS, BB, BF, BM, BS, CA, CR, DM, DO, EC, GD, GU, JM, KN, KY, LC, MP,
645   MS, PR, SO, SX, TC, TT, US, VC, VG, VI
646 - Updated carrier data for country calling code(s): 226 (en)
647
648Dec 13, 2013: libphonenumber-5.9.1
649* Metadata changes:
650 - New alternate formatting data for country calling code(s): 505, 679
651 - Updated phone metadata for region code(s):
652   BF, CI, EG, EH, FJ, IN, KI, MA, MT, NG, NI, SI, SN, SR, TT
653 - Updated short number metadata for region code(s): KI
654 - Updated geocoding data for country calling code(s):
655   27 (en), 226 (en), 1 (en)
656 - New carrier data for country calling code(s): 356 (en), 677 (en)
657 - Updated carrier data for country calling code(s):
658   212 (en), 221 (en), 225 (en), 226 (en), 234 (en), 597 (en), 1 (en)
659
660Nov 12, 2013: libphonenumber-5.9
661* Code changes:
662 - Adding support for numbers with multiple Italian leading zeros, by adding a field
663   to the phone number proto to allow an arbitrary number of leading zeros, and
664   supporting this when parsing, validating and formatting.
665 - Adding more functionality to ShortNumberInfo -> such as getExpectedCostForRegion.
666 - Fix for parsing short numbers that start with the national prefix.
667 - Updating formatNumberForMobileDialing to work with short numbers.
668 - Stop finding Israeli 4-digit "star" numbers in text when no star is in fact present.
669 - Bug fix for finding phone numbers where the area code was also part of the country
670   calling code.
671
672* Metadata changes:
673 - Updated phone metadata for region code(s):
674   AU, BQ, BY, CI, CO, CW, GN, HN, IN, JO, KI, KW, MG, MK, MM, NA, PK, TC, TM,
675   UG
676 - New short number metadata for region code(s): CD, GN
677 - Updated short number metadata for region code(s):
678   AF, AG, AI, AM, AR, AS, AW, AZ, BD, BH, BI, BM, BO, BQ, BT, BW, BY, CA, CH,
679   CI, CM, CO, CW, DZ, FJ, GD, GE, GH, GT, GY, HN, HT, ID, IE, IM, IN, IQ, JM,
680   JO, KE, KG, KH, KI, KW, KZ, LR, SV
681 - New geocoding data for country calling code(s):
682   257 (en), 389 (en), 599 (en), 686 (en), 962 (en)
683 - Updated geocoding data for country calling code(s):
684   264 (en), 375 (be, en, ru)
685 - New carrier data for country calling code(s):
686   375 (be, ru), 389 (en), 599 (en), 965 (ar)
687 - Updated carrier data for country calling code(s):
688   57 (en), 61 (en), 92 (en), 225 (en), 256 (en), 257 (en), 261 (en), 375 (en),
689   686 (en), 962 (en), 965 (en)
690
691Oct 10, 2013: libphonenumber-5.8.8
692* Metadata changes:
693 - New alternate formatting data for country calling code(s):
694   350, 358, 36, 66, 84, 94, 995
695 - Updated alternate formatting data for country calling code(s):
696   31, 359, 372, 49, 62, 7
697 - Updated phone metadata for region code(s):
698   AR, BD, BE, BF, BR, CO, CR, FI, GI, GM, IS, MU
699 - Updated short number metadata for region code(s): AR, BE, ES, GI, PG, US
700 - Updated geocoding data for country calling code(s): 220 (en)
701 - Updated carrier data for country calling code(s):
702   20 (en), 220 (en), 224 (en), 230 (en), 852 (en)
703
704Oct 8, 2013: libphonenumber-5.8.7
705* Code changes:
706  - New method in the PhoneNumberUtil API - isMobileNumberPortableRegion.
707  - Carrier mapper: Updated API and added a getSafeDisplayName method that only returns the carrier
708                    if it's safe to display to the user.
709
710Oct 7, 2013:
711* Code changes:
712  - Added PhoneNumberToTimeZonesMapper including unittests to the geocoder maven project.
713  - Added build rules for generating the binary time zones mapping file from the text file.
714  - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate time zone mapping.
715* Metadata changes:
716  - Added the time zone mapping file.
717
718Sep 30, 2013:
719* Code changes:
720  - Added PhoneNumberToCarrierMapper including unittests.
721  - Added build rules for generating binary carrier mapping files from text files.
722  - Modified PhoneNumberParserServlet.java (the appengine demo) to incorporate carrier mapping.
723* Metadata changes:
724  - Added carrier mapping files for some NANPA countries, EG, SS, MA, DZ, TN, GM, SN, MR, ML, GN,
725    CI, BF, NE, TG, BJ, MU, LR, SL, GH, NG, TD, CF, CM, CV, ST, GQ, GA, CG, CD, AO, GW, SC, SD, RW,
726    ET, SO, DJ, KE, TZ, UG, BI, MZ, ZM, MG, ZW, MW, BW, SZ, ZA, AW, FO, GL, GR, NL, BE, FR, GI, PT,
727    LU, IE, AL, CY, FI, BG, HU, LT, EE, AM, BY, AD, UA, RS, HR, SI, BA, IT, RO, CH, CZ, SK, AT, DK,
728    NO, PL, DE, BZ, CR, PE, CU, AR, BR, CL, CO, VE, BO, PY, SR, UY, MY, AU, ID, PH, NZ, SG, TH, TL,
729    BN, PG, TO, VU, FJ, WS, KI, RU, VN, HK, KH, LA, CN, BD, TR, IN, PK, AF, LK, MV, JO, IQ, KW, SA,
730    YE, OM, PS, AE, IL, BH, QA, BT, NP, IR, TJ, TM, AZ, GE, KG and UZ in English.
731
732Sep 23, 2013: libphonenumber-5.8.6
733* Code changes:
734  - Restructured the geocoder binary generation code, moving the classes under tools/ from
735    geocoding/ to buildtools/ and renaming AreaCode to PhonePrefix.
736
737Sep 23, 2013: libphonenumber-5.8.5
738* Code changes:
739  - Restructured the geocoder, moving the utility classes to a new module internal/prefixmapper.
740
741Sep 20, 2013: libphonenumber-5.8.4
742* Metadata changes:
743 - Adding a token to indicate which countries have mobile portability.
744
745Sep 20, 2013: libphonenumber-5.8.3
746* Code changes:
747  - PhoneNumberOfflineGeocoder: Moved utility functionality to PrefixFileReader.
748  - Bug fix: Argentinian (and other countries with mobile tokens) mobile numbers now geocode
749             correctly.
750
751Sep 19, 2013: libphonenumber-5.8.2
752* Code changes:
753  - New method in the PhoneNumberUtil API - getCountryMobileToken.
754
755Sep 19, 2013: libphonenumber-5.8.1
756* Metadata changes:
757 - New alternate formatting data for country calling code(s): 675
758 - Updated phone metadata for region code(s):
759   AO, AU, BF, BW, CA, CH, CI, CN, DE, FR, MA, MR, MU, NI, PG, SA, SE, US, VI
760 - New short number metadata for region code(s): IQ
761 - Updated short number metadata for region code(s):
762   AU, BR, DO, EG, FR, GH, ID, IL, JM, KE, KZ, LR, MW, NG, NI, SA, SE, SL, TZ, US, UZ
763 - New geocoding data for country calling code(s):
764   966 (ar, en), 1 (en)
765
766Sep 2, 2013: libphonenumber-5.8
767* Code changes:
768 - Renamed ShortNumberUtil to ShortNumberInfo -> the former class is now deprecated and will be
769   deleted in a later release. At the moment it just delegates to ShortNumberInfo.
770 - New methods in the ShortNumberInfo API - isCarrierSpecific, singleton interface,
771   isPossibleShortNumber, isValidShortNumber, getShortNumberCost. Note this is an experimental API
772   at the moment and subject to change.
773 - Bug fixes:
774    -- AsYouTypeFormatting: 3-digit numbers can be formatted as a group where appropriate
775    -- AsYouTypeFormatting: Countries with an optional national prefix were considered before to
776       have always entered it, resulting in bugs where numbers without the national prefix were
777       not properly formatted.
778    -- Numbers in Chile that overlap with emergency numbers are no longer marked as connecting to
779       them
780    -- Not requiring the NDC to be alone for countries where there is no national prefix in strict
781       grouping when extracting phone numbers
782* Metadata changes:
783 - New alternate formatting data for country calling code(s):
784   30, 31, 385, 58, 62, 63, 971, 972
785 - Updated alternate formatting data for country calling code(s): 43, 44, 49
786 - Moved emergency phone number data to the ShortNumberMetadata.xml file
787 - Updated phone metadata for region code(s):
788   AT, EG, ML, NC, NL, SA
789 - New short number metadata for region code(s):
790   AR, CL, CO, ES, MX, NC
791 - Emergency metadata fixes for region code(s):
792   GA, JM, MH, VE
793
794Aug 09, 2013: libphonenumber-5.7.2
795* Metadata changes:
796 - New alternate formatting data for country calling code(s):
797   352, 359, 372, 373, 375, 595, 7, 855
798 - Updated phone metadata for region code(s):
799   AR, BF, BH, BR, BY, CH, CM, CN, GE, GW, HN, JM, KH, LT, LU, MU, NP, RO, SO
800 - New short number metadata for region code(s): BR
801 - Updated short number metadata for region code(s):
802   CH, FJ, GB, GG, IM, IT, JE, SH
803
804Aug 8, 2013: libphonenumber-5.7.1
805* Metadata/code changes:
806 - Change to the way the metadata is built; now only parts of the proto that are relevant will be
807   generated. This means short-code data won't be generated for the normal protos, and fixed-line
808   data won't be generated for short-number protos. This cuts the metadata binary size approximately
809   in half.
810
811Jul 17, 2013: libphonenumber-5.7
812* Code changes:
813 - Improve phone number extraction recall.
814 - Add support for loading short number metadata.
815
816Jul 16, 2013: libphonenumber-5.6.2
817* Metadata changes:
818 - Updated alternate formatting data for country calling code(s): 49, 61
819 - New metadata for region code(s): TA
820 - Updated metadata for region code(s):
821   BF, BH, BI, BJ, BR, CR, EH, GA, GE, GN, GU, IL, IN, IR, KH, KW, KZ, MA, MT,
822   NA, NE, NL, PH, RO, SH, SO, TK
823 - New geocoding data for country calling code(s): 47 (en), 82 (ar)
824 - Updated geocoding data for country calling code(s):
825   49 (en), 98 (en, fa), 241 (en)
826
827Jul 12, 2013: libphonenumber-5.6.1
828* Code changes:
829 - Rename all instances of PhoneNumberMetadata to PhoneNumberMetadata for consistency.
830
831Jun 05, 2013: libphonenumber-5.6
832* Code changes:
833 - Fix for as-you-type-formatting bug affecting countries with no national prefix
834   formatting rule, such as China.
835* Metadata changes:
836 - New alternate formatting data for country calling code(s): 351
837 - Updated alternate formatting data for country calling code(s): 49
838 - Updated metadata for region code(s):
839   AS, BG, BH, BJ, BL, CD, CI, DE, DZ, EH, FJ, GF, GP, IN, KH, KZ, MA, MD, MF,
840   ML, MY, NG, PT, PY, TC, TJ, TT
841
842May 08, 2013: libphonenumber-5.5
843* Code changes:
844 - Changed internal initialization code and made more fields final.
845   Note that we now throw an exception if an attempt is made to set the
846   metadata more than once (which should only happen during testing).
847 - Fix problem with formatNumberForMobileDialing for HU and CL.
848* Metadata changes:
849 - Updated alternate formatting data for country calling code(s): 49
850 - Updated metadata for region code(s):
851   AM, BF, BR, CR, DE, MA, MG, MM, SA, TL, UA
852 - Updated geocoding data for country calling code(s): 374 (am, en, ru)
853
854Apr 19, 2013: libphonenumber-5.4.2
855* Metadata changes:
856 - Updated metadata for region code(s): BF, GA, IN, KR, MV, PH, SO, UA, US
857
858Mar 25, 2013: libphonenumber-5.4.1
859* Metadata changes:
860 - Updated metadata for region code(s): BF, BH, CR, EC, IR, MG, PF, TD, TN
861 - New geocoding data for country calling code(s): 374 (am, ru)
862 - Updated geocoding data for country calling code(s):
863   98 (en, fa), 358 (en, se), 374 (en)
864
865Mar 07, 2013: libphonenumber-5.4
866* Code changes:
867 - Switch formatNumberForMobileDialing to prefer national format to international format when the
868   number is dialed from the same region the phone number is from.
869
870* Metadata changes:
871 - Updated metadata for region code(s):
872   BF, CD, CN, CZ, GN, IR, JP, KR, KW, LR, NZ, TT, UG, ZW
873 - New geocoding data for country calling code(s): 82 (cs)
874 - Updated geocoding data for country calling code(s):
875   82 (en, fr, ko, zh, zh_Hant), 98 (en, fa), 263 (en)
876
877Feb 11, 2013: libphonenumber-5.3.2
878* Metadata changes:
879 - Updated metadata for region code(s):
880   BD, BE, BY, CA, EH, GR, IE, IN, IS, LI, MA, MU, PT, SE, SG, TL
881 - New geocoding data for country calling code(s):
882   375 (be, en, ru), 1 (en)
883
884Jan 25, 2013: libphonenumber-5.3.1
885* Metadata changes:
886 - Updated metadata for region code(s): CN, DK, EH, GN, KH, KW, MA, MY, PA
887
888Jan 08, 2013: libphonenumber-5.3
889* Code changes:
890 - Handling UAN numbers in Argentina better when dialling them locally from a
891   mobile
892* Metadata changes:
893 - Updated metadata for region code(s):
894   BE, BW, CL, CN, CO, EH, KW, MA, ML, NG, PL, SY, ZA, ZM
895 - New geocoding data for country calling code(s): 32 (en, fr, nl)
896 - Updated geocoding data for country calling code(s): 27 (en), 86 (en, zh)
897
898Dec 06, 2012: libphonenumber-5.2.2
899* Metadata changes:
900 - New metadata for region code(s): EH
901 - Updated metadata for region code(s): BR, CL, CR, IN, MA, PG, PK, RO
902 - New geocoding data for country calling code(s): 241 (en)
903
904Nov 26, 2012: libphonenumber-5.2.1
905* Metadata changes:
906 - Updated metadata for region code(s):
907   AE, AW, BF, CN, DE, JO, KE, KH, LT, MM, MU, NG, RW, SR, TR, VU
908 - New geocoding data for country calling code(s): 359 (bg, en)
909
910Oct 10, 2012: libphonenumber-5.2
911* Code changes:
912 - Adds isNumberGeographical() method.
913 - Adds getRegionCodesForCountryCode() method.
914 - Fixing issue with getSupportedGlobalNetworkCallingCodes()
915   [https://github.com/googlei18n/libphonenumber/issues/202]
916 - Ensures that returned collections are unmodifiable where necessary
917   [there is a very slight risk that this may break existing users who were relying on being able
918   to modify these collections, but doing so would be breaking lots of other assumptions that this
919   library makes - if you need to modify any affected collections you must copy them first]
920* Metadata changes:
921 - Updated metadata for region code(s): DE, GR, HR, OM, SB, ZA
922 - Removed metadata for region code: AN (Netherlands Antilles)
923 - Updated geocoding data for country calling code(s): 30 (el, en)
924
925Sep 27, 2012: libphonenumber-5.1.4
926* Metadata changes:
927 - Updated metadata for region code(s): AU, EC, KH, LB, TN, US
928
929Sep 17, 2012: libphonenumber-5.1.3
930* Metadata changes:
931 - Updated metadata for region code(s): EG, LA, LB, LI, PY
932 - Updated metadata for non-geographical calling codes: 800, 808, 888, 979
933 - Updated geocoding data for country calling code(s): 98 (en), 1 (en)
934
935Sep 11, 2010: libphonenumber-5.1.2
936* Bug fix:
937 - Fixing regression in AsYouTypeFormatter where it no longer worked for numbers entered in national
938   format for countries with no national prefix, e.g. Spain.
939
940Sep 5, 2010: libphonenumber-5.1.1
941* Code changes:
942  - Added better logging/exception handling for catching cases where metadata is invalid/missing.
943
944Sep 3, 2012: libphonenumber-5.1
945* Code changes:
946 - Inserting a space after the national prefix in the AsYouTypeFormatter when formatting numbers in
947   national format, if the formatting rules for that country dictate that a space is appropriate.
948 - Format emergency numbers and short-codes as a block in the AsYouTypeFormatter.
949* Metadata changes:
950 - Updated metadata for region code(s): BF, BG, DZ, GA, IT, JP, KW, PF
951
952Aug 20, 2012: libphonenumber-5.0.3
953* Metadata changes:
954 - New alternate formatting data for country calling code(s): 43
955 - Updated metadata for region code(s): AT, BF, JO, NG, RU, SL
956 - New geocoding data for country calling code(s): 62 (en, id), 98 (fa)
957
958Aug 07, 2012: libphonenumber-5.0.2
959* Metadata changes:
960 - Updated metadata for region code(s):
961   BF, CN, DJ, IL, JO, KH, KZ, MA, MT, MV, MY, NC, NG, SD, SK, SN, TL, UZ
962 - New geocoding data for country calling code(s): 7 (ru), 98 (en)
963 - Updated geocoding data for country calling code(s): 7 (en)
964
965July 26th, 2012: libphonenumber-5.0.1
966* Metadata changes
967 - CL, DE ,IN, KR, US
968 - New geocoding data for country calling codes 40, 57, 66, 82, 91.
969 - Fixed comments for 353 (IE).
970
971July 12th, 2012: libphonenumber-5.0
972* Code changes:
973 - Support for alternate formats when finding phone numbers.
974 - Allowing two-digit numbers to be parsed if they are entered in national-format with no
975   punctuation
976* Metadata changes
977 - IL, GA
978* Other
979 - Reflowed this file to 100 char width to make it unambiguous as to what the standard should be.
980
981July 6th, 2012: libphonenumber-4.9.1
982* Metadata changes
983 - AR, BA, BF, CR, DE, EC, ES, KZ, MK, NC, NG, PF, SB, UZ, non-geo entity 882
984 - Geocoding data updates for country calling codes 54 (AR) and 81 (JP), new data for 234 (NG)
985
986June 21st, 2012: libphonenumber-4.9
987* Bug fix
988 - formatInOriginalFormat fixed not to add a star sign if it was not present originally.
989* Metadata changes
990 - BF, CZ, ES, KW
991 - Non-geographical entities with calling code 882 (BebbiCell, Maritime Communications, Oration
992   Technologies, Telespazio and Thuraya)
993 - Geocoding data updates for country calling codes 221, 224, 226, 242, 244, 245
994* Functionality changes:
995 - Minimum allowed length for a national significant number (NSN) when parsing changed from 3 to 2.
996 - Support parsing of RFC3966-formatted strings with an isdn-subaddress or extra parameters
997   specified.
998 - Allow soft hyphen to appear in phone numbers (\u00AD)
999* Testing changes:
1000 - Add extra unit tests for non-geographical phone number entities
1001 - ExampleNumbersTest testEmergency tests now uses ShortNumberUtil
1002
1003June 14th, 2012: libphonenumber-4.8.5
1004* Metadata update only:
1005 - AC, CR, DE, DK, IL, IN, IS, KH, LI, LR, MA, MD, MK, PA, SA, SG, SS
1006
1007June 6th, 2012: libphonenumber-4.8.4
1008* Metadata update only:
1009 - AE, RO
1010 - Non-geographical entity with calling code 881 (Iridium)
1011
1012May 30th, 2012: libphonenumber-4.8.3
1013* Metadata update only:
1014 - AN, ET, KW, MN, SX, TC, TL
1015
1016May 16th, 2012: libphonenumber-4.8.2
1017* Metadata update only:
1018 - BH, CR, EE, JO, KW, LA, QA, SI, TH
1019 - Non-geographical entity with calling code 878 (VISIONng)
1020
1021May 8th, 2012: libphonenumber-4.8.1
1022* Metadata update only:
1023 - CA, CI, EG, HK, IN, IR, LB, MA, ME, MM
1024 - Non-geographical entity with calling code 870 (Inmarsat)
1025 - Geocoding updates for country calling codes 1 for new area codes
1026
1027April 24th, 2012: libphonenumber-4.8
1028* Functionality changes
1029 - RFC format now outputs a number starting with "tel:"
1030 - Parsing support for numbers in RFC format that contain the country info in the "phone-context"
1031   part
1032 - Support for obtaining area codes for Italy, Vatican City, San Marino
1033* Metadata changes
1034 - AM, AO, AR, BE, BF, CD, EG, GH, GM, GN, IN, IR, IT, JO, LA, LC, MD, MS, NO, PA, PK, SI, SJ, SO,
1035   SY, TC, TN, UZ, VN, ZW
1036 - Geocoding updates for country calling codes 1, 20, 233, 31, 33, 352, 374, 54, 56, 86
1037* Refactoring of matching functions, including moving them to PhoneNumberMatcher.
1038
1039March 16th, 2012: libphonenumber-4.7
1040* Bug fixes
1041 - Now return "too long" for input that is longer than 250 chars when parsing
1042* Metadata changes
1043 - 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,
1044   MK,NA,NE,NZ,SA,SB,SC,SE,SL,SN,UZ
1045* Refactoring of test classes so that tests requiring the test metadata to be loaded have a common
1046  base class which handles this.
1047
1048February 9th, 2012: libphonenumber-4.6
1049* Bug fixes
1050 - Fix for formatByPattern to enable RFC formatting to work
1051 - Fix for RFC formatting to work even when the international formatting rule starts with
1052   punctuation
1053 - Logging consistency changes - some warnings are no longer printed, others have become only
1054   WARNINGS
1055 - Fix for isValidNumberForRegion potentially throwing a NPE
1056 - Parsing Israeli * numbers written in international format now works
1057 - PhoneNumberMatcher doesn't match timestamps as phone-numbers
1058* Metadata changes
1059 - Updates for AN, AX, BF, BJ, BR, BS, DJ, FI, IN, LV, MW, RS, SC, VN
1060 - New countries supported: SS (South Sudan), CW (Curaçao) and BQ (Bonaire, Sint Eustatius and Saba)
1061* Refactoring of the private formatting functions in PhoneNumberUtil to ensure names are more
1062  descriptive and to reduce code duplication.
1063
1064January 19th, 2012: libphonenumber-4.5
1065* Code changes
1066 - Support for non-geographical country calling codes (e.g. +800).
1067 - Modify formatInOriginalFormat to not insert/remove/modify digits in the original number passed
1068   in.
1069 - Fix formatOutOfCountryKeepingAlphaChars to not throw a NPE.
1070
1071* Metadata changes
1072 - Updates for AR, BH, CI, CN, CR, DE, GA, IL, JO, JP, KE, KZ, LB, LK, LT, MV, MW, MZ, NA, NL, NZ,
1073   PL, RO, SA, SV, TM, UG, US
1074 - New country calling codes: 800, 808, 883, 888, 979
1075 - Geocoding data updates: AR, US
1076
1077December 9th, 2011: libphonenumber-4.4
1078* Code changes
1079 - Support for Voicemail numbers
1080 - Support prefixes "xt" and "xtn" to indicate extensions of phone numbers
1081 - Change formatInOriginalFormat to use raw_input for numbers with incorrect leading zeroes, instead
1082   of all invalid numbers.
1083
1084* Metadata changes
1085 - Updates for AR, BD, CH, CI, IL, IR, IS, IT, JP, KW, LR, MM, NG, SA, SC, UZ
1086
1087November 24th, 2011: libphonenumber-4.3
1088* Code changes
1089 - Fix the problems with AYTF crashing for longer numbers entered with +CountryCode, and incorrectly
1090   removing national prefix for some numbers.
1091 - Improve PhoneNumberMatcher to not match numbers ending with '%'.
1092 - Fix formatNumberForMobileDialing to handle Israeli star numbers, Peruvian and Colombian numbers.
1093 - Modify formatInOriginalFormat to use the raw input if we don't have a formatting pattern for a
1094   number.
1095 - Simple offline geocoding function which takes into account the user's region.
1096
1097* Metadata changes
1098 - Updates for CR, GN, JP, KE, PL, SG, SR, SX, TH, TK
1099
1100November 10th, 2011: libphonenumber-4.2
1101* Code changes
1102 - Providing an "exact match" isEmergencyNumber method
1103 - Improvement to PhoneNumberMatcher: requires national prefix to be present when matching
1104   national-format numbers, unless matching for a region where it is explicitly marked in the
1105   metadata that they may be omitted. Applies to leniency level VALID and higher.
1106 - Change formatNumberForMobileDialing not to modify the phoneNumber passed in.
1107
1108* Metadata changes
1109 - Emergency numbers added for all remaining countries
1110 - Collected data on which numbers we format with a national prefix are commonly written without one
1111   and added this
1112 - Updates for AR, AT, BH, CZ, GR, IR, KM, LT, MX, PT, SE, SO, UG
1113 - Addition of SX (Sint Maarten)
1114
1115October 19th, 2011: libphonenumber-4.1
1116* Code changes
1117 - Update code and metadata for countries with IDD "8~10" to accept phone numbers where the "~" is
1118   omitted.
1119 - Modify formatInOriginalFormat to use raw_input (when present) when the number is considered as
1120   invalid by the library.
1121 - Add ShortNumberUtil to deal with international short phone numbers, such as short codes and
1122   emergency numbers.
1123 - Increase the maximum phone-number length accepted when parsing (now set to
1124   16).
1125
1126* Metadata changes
1127 - Updates: BF, BN, CN, DE, DK, DO, FR, IN, KI, KW, MC, MD, ML, PA, QA, SB, UK, WS
1128 - Emergency number information also added to: AE, AF, AL, AM, AR, AT, AU, BA,
1129   BB, BD, BE, BG, BH, BO, BR, BY, CA, CH, CL, CN, CO, CR, CY, CZ, DE, DJ, DK,
1130   DO, DZ, EC, EE, EG, ES, FI, FJ, FO, FR, GB, GE, GF, GH, GI, GL, GR, GT, GY,
1131   HK, HN, HR, HU, ID, IE, IL, IN, IR, IS, IT, JM, JO, JP, KR, KW, KY, KZ, LB,
1132   LK, LT, LU, LV, MA, MC, MD, ME, MK, ML, MM, MN, MO, MT, MU, MV, MX, MY, NG,
1133   NI, NL, NO, NP, OM, PA, PE, PH, PK, PL, PM, PT, PY, QA, RO, RS, RU, RW, SA,
1134   SB, SD, SE, SG, SI, SK, SL, SM, SR, SV, SY, TD, TH, TJ, TM, TN, TR, TT, TW,
1135   UA, UG, US, UY, UZ, VA, VE, VN, VU, ZA, ZM, ZW
1136
1137October 6th, 2011: libphonenumber-4.0
1138* Code changes
1139 - New function formatNumberForMobileDialing, which attempts to format a number in such a way that
1140   the call can be connected from a mobile phone. If this is impossible, for example for numbers
1141   that cannot be internationally dialled, then an empty string is returned.
1142 - Fallback functionality to English for non-CJK languages for geocoding
1143
1144* Metadata changes
1145 - Collecting data for emergency numbers
1146 - Updates: AR, AU, BR, CN, CZ, EG, GD, IE, IL, JM, KW, KH, SD, SO, TR, UG, UZ
1147 - Geocoding data changes: AO, AR, AT, BJ, BR, CD, CG, CI, CL, CN, CV, DE, ES,
1148   FR, GR, GW, HU, KM, MR, MZ, NL, PL, PT, SE, ST, SZ
1149
1150September 13th, 2011: libphonenumber-3.9
1151* Code changes
1152 - Enable AsYouTypeFormatter to handle long IDD and NDD.
1153 - Allow the presence of an IDD following a +.
1154 - Fix formatting of phone numbers which contain only 0s in the national number.
1155 - Refactored some code in geocoding including AreaCodeMap and the storage strategies.
1156
1157* Metadata changes
1158 - Updates: AM, BE, BH, BJ, BR, BT, BZ, CI, CL, CN, DE, DK, DM, DZ, EC, EG, FJ,
1159   GR, HR, HT, IN, IQ, IS, JM, KE, KG, KH, KR, LA, LB, LR, MA, MD, ML, MO, MX,
1160   MY, NE, NG, PG, PH, PK, PY, QA, SA, SD, SG, SN, TD, TG, TH, TN, TT, UG, YE,
1161   ZA, ZM
1162 - New geocoding data for: AC, CG, CU, CV, EG, ET, FI, FI, FI, GL, JP, KM, MA,
1163   MA, MU, MU, MU, MZ, RS, SH, SH, SL, SO, ST, TG, TG, TG, UG, ZM
1164 - Updated geocoding data for: AR, DE
1165
1166August 11th, 2011: libphonenumber-3.8
1167* Code changes
1168 - Fix to demo to not throw null-ptr exceptions for invalid NANPA numbers
1169 - Fixed AYTF to not accept plus signs in the middle of input
1170 - PhoneNumberMatcher improvements - added STRICT_GROUPING and EXACT_GROUPING levels, numbers
1171   followed/preceded by a currency symbol will not match, multiple numbers separated by phone-number
1172   punctuation will now match. ", " is no longer accepted as an extension symbol when matching, only
1173   when parsing. "x" is only accepted as a carrier code or extension marker, not otherwise.
1174 - Changes to handling of leading zeroes - these will not be silently ignored anymore, but will be
1175   stored as part of the number.
1176 - PhoneNumberOfflineGeocoder - new method to get the description of a number that assumes the
1177   validity of the number has already been checked and will not re-verify it.
1178 - Split geocoding US binary data into multiple files.
1179
1180* Metadata changes
1181 - Updates: AR, AT, AU, AZ, BE, BF, BH, BY, CA, CN, CO, CR, HT, HU, IT, KG, KH,
1182   LB, LI, ME, NC, RS, SE, TT, US, VG, ZA
1183 - New geocoding data for: AL, AM, AO, BF, BJ, BW, CD, CI, CZ, DZ, EE, GH, GM,
1184   GN, GR, GW, HU, IS, KE, LK, LS, LT, LU, LV, MD, MG, MR, NA, PE, QN, SD, SK,
1185   SN, SZ, TN, VE, VN, ZA, ZW
1186 - Updated geocoding data for: GB, PT, US
1187 - Revised sorting of geocoding data
1188
1189July 5th, 2011
1190* Code changes
1191 - Refactored AreaCodeMap to minimize binary and memory footprint by using 2 different strategies.
1192 - Refactored BuildMetadataFromXml.java and added unittests.
1193
1194* Metadata changes
1195 - Regenerate binaries for all existing area code mapping data with smaller sizes.
1196 - Added city-level area code data mapping for US and Canada.
1197
1198June 29th, 2011
1199* Code changes
1200 - Fixed issue 38, issue 39, issue 41 and issue 43
1201
1202* Metadata changes
1203 - Added phone number area mapping files for
1204   - JP in Japanese
1205   - FR in French
1206   - TW in English, Simplified and Traditional Chinese
1207   - RU in English
1208   - IT in English and Italian
1209   - PT in Portuguese
1210   - TR in English and Turkish
1211   - CH in English, German, French and Italian
1212 - Updates: CR, GE, IT, JP, KW, MH, MP, MU, PE, PM, RW, TG, TJ, TK
1213
1214June 14th, 2011
1215* Code changes
1216 - Added PhoneNumberOfflineGeocoder, supporting classes and their unittests.
1217 - Added GenerateAreaCodeData to transform phone number area mapping files from text files to binary
1218   files.
1219 - Modified PhoneNumberParserServlet.java and phonenumberparser.jsp to incorporate
1220   PhoneNumberOfflineGeocoding in the appengine demo.
1221
1222* Metadata changes
1223 - Added phone number area mapping files for NANPA countries and GB in English, NL in Dutch, AR, CL
1224   and ES in Spanish, AT and DE in German, SE in Swedish, BR in Portuguese, KR in English, Korean,
1225   Simplified and Traditional Chinese, and CN in Simplified Chinese.
1226
1227June 10th, 2011
1228* Code changes:
1229 - Fixes for PhoneNumberMatcher to be more restrictive in valid mode and not match numbers
1230   surrounded by Latin characters. This ensures, for example, the string abc123456789acg will not be
1231   marked as a phone numbers.
1232 - Enable PhoneNumberUtil to handle all digits, rather than a subset
1233 - Fix for AYTF issue36 and improvement for US AYTF behaviour.
1234* Metadata changes:
1235 - Updates: BG, EG, ES, GH, PF, SC, SY, VA
1236
1237May 24th, 2011
1238* Code changes:
1239 - Phonenumber now implements Serializable.
1240 - findNumbers doesn't accept numbers with mis-matched brackets as phone-numbers
1241 - An offline phone number geocoder has been added. The current implementation just returns the
1242   region name for the phone number; more detailed geocoding will be added later.
1243* Metadata changes:
1244 - New countries: GF, KP, NC, PA, PF, PW, PY, SB, SR, TO, UY, VU
1245 - Updates: CY, CZ, ES, GB, GQ, JM, MQ, TN, VI
1246
1247May 9th, 2011
1248* Code changes:
1249 - Fixed potential for a null-ptr exception in getExampleNumber
1250 - Potential speed improvement with replacement of StringBuffer with StringBuilder
1251* Metadata changes
1252 - Changed way that international formats are specified to make it easier to do so
1253 - New countries: AX, CC, CX, WF
1254 - Updates: AM, AR, AU, AW, CN, CO, CR, DM, EC, ET, FI, FJ, GH, IN, JP, KE, KM,
1255   KN, LR, MD, MQ, MX, NP, PH, SC, SE, SM, SN, SY, UG, US, VC, VI, ZM
1256
1257Apr 26th, 2011
1258* Code changes:
1259 - Improved PhoneNumberMatcher for cases with other numbers before or after the phone number.
1260 - Improved AsYouTypeFormatter not to use formatting rules containing non-formatting characters
1261   (e.g. '*' in Israeli star numbers).
1262* Metadata changes:
1263 - New countries: FJ, FM, GY, NF, NI, NR, TV.
1264 - Updates: AM, AZ, BF, BW, BZ, CI, CR, GB, GP, HK, JM, KH, LB, LY, MV, PE, PK, SZ, TJ, US.
1265* Minor documentation updates
1266
1267Apr 11th, 2011
1268* Bug fixes:
1269 - Adding date exclusion pattern in PhoneNumberMatcher.
1270 - Fixing bug with selecting a suitable region for numbers with leading zeros where mutiple regions
1271   for that country code are possible.
1272* Metadata changes:
1273 - Updates: AG, AI, AS, BB, BM, BS, CA, DM, DO, ET, FO, GD, GE, GU, IN, JM, KN, KY, LC, MN, MP, MR,
1274   MS, NO, PR, TC, TR, TT, US, VC, VG, VI
1275 - New countries: CK, FK, GT, IO, KI, SJ, SV
1276* Documentation updates and some small refactoring to AsYouTypeFormatter
1277
1278Mar 31st, 2011
1279* New functionality:
1280 - Can parse and format numbers in RFC-3966 format.
1281 - Added isAlphaNumber to check to see if a number is a "vanity" or "alpha" number
1282 - Can format a number made up of alpha-characters in an "out-of-country" format (e.g. 0011 1
1283   800-SIX-FLAG to dial an American alpha-number from Australia).
1284* Code changes:
1285 - Renamed private vars, private methods and fixed comments to try and differentiate between country
1286   (calling) codes and region codes.
1287 == Non-backwards-compatible API changes: ==
1288 - Renamed getSupportedCountries to getSupportedRegions, as this more accurately reflects that the
1289   library is based around region codes.
1290 - getNationalSignificantNumber is no longer a static method, but is instead an instance method.
1291* Metadata changes:
1292 - Bug-fixes and updates for AU, AZ, EE, FI, IN, JO, KW, KZ, MV, RU, RR, VA
1293 - New country: ME
1294
1295Mar 22nd, 2011
1296* Metadata changes:
1297 - New mobile-number pattern for AU
1298
1299Mar 10th, 2011
1300* New functionality:
1301 - New function to format a number with the preferred domestic carrier code used when parsing,
1302   falling back to a default calling code otherwise (formatNationalNumberWithPreferredCarrierCode).
1303 - We now store the preferred domestic carrier code used when the user calls parseAndKeepRawInput
1304 - New functionality to extract phone-numbers from text (findNumbers). This is just the first
1305   version - it does not extract ALPHA numbers such as 0800 CALL ME, or numbers where alternate
1306   endings are specified (such as 03-331 6005/6006).
1307* Code changes:
1308 - Tidying up the test file to use several pre-defined phone number constants
1309 - Fixing several lint errors
1310 - Added javadoc to formatNationalNumberWithCarrierCode
1311 - Fixed bug where a null pointer exception was thrown when getAsYouTypeFormatter was called with an
1312   invalid region code
1313 - Improved AsYouTypeFormatter to deal with countries with variable-length patterns such as LU
1314* Metadata changes:
1315 - Bug-fixes and updates for the following countries: BF, BO, BR, CL, CO, CR, DK, FO, GE, KR, KW,
1316   LA, LU, MU, SC, SH, TR, VE
1317 - New country: SH
1318
1319Mar 10th, 2011
1320* Code changes:
1321  - releasing the code to run the demo on localhost or appengine.
1322
1323Mar 7th, 2011
1324* Metadata changes:
1325 - Adding support for AC
1326
1327Feb 11th, 2011
1328* Metadata changes:
1329 - Update UAN number ranges for IM and JE.
1330
1331Feb 9th, 2011
1332* Code changes:
1333  - Better isNumberMatch method. This will now recognise numbers starting with a national prefix as
1334    an NSN_MATCH, instead of SHORT_NSN_MATCH.
1335    == Note Non-backwards-compatible API change here! ==
1336      This will no longer throw a NumberParseException - instead we will return NOT_A_NUMBER if one
1337      or other of the numbers provided do not match.
1338  - New number-type UAN now supported in the code. This represents Company Numbers or Universally
1339    Accessible Numbers.
1340* Metadata changes:
1341  - Bug-fixes and updates for the following countries: AG, AZ, BA, BE, CA, CU, ES, FI, GB, GD, GG,
1342    IE, IL, IM, IN, IR, IT, JE, JP, KR, KW, NG, NZ, PK, PS, PT, RU, SE, SG, SY, US
1343  - New countries: CO, LU, LY, MC, SM
1344  - Addition of "Personal Number" ranges to all NANPA countries
1345
1346Jan 31st, 2011
1347* Code changes:
1348  - Introducing equals() and hashCode() methods for the Phonenumber.PhoneNumber class
1349
1350Jan 28th, 2011
1351* Code changes:
1352  - Fixing critical bug with non-Android-compatible code. isEmpty() was being used and CANON_EQ in
1353    reg-ex matches.
1354
1355Jan 20th, 2011
1356* Code improvements:
1357  - Handle null phone-numbers when parsing by throwing a NumberParseException.
1358  - Handle extension written with an accented "o", as per Spanish, when parsing.
1359  - Handle U+30FC dashes as phone-number punctuation.
1360  - Allow "ZZ" or null regions to be specified for numbers starting with a full-width "+" symbol, or
1361    with other characters (such as whitespace) before the leading +.
1362  - new getLengthOfNationalDestinationCode function
1363* Metadata changes:
1364  - New types of numbers introduced: UAN (universal or "company" numbers) and short codes. Note that
1365    "generalDesc" patterns do not encompass short-codes.  No code-support for these has been
1366    introduced as of yet. We are also now enabling the collection of data for information such as
1367    area-code-optional, and no-international-dialling ranges.
1368  - Data updates as per ITU notifications/bug fixes for the following countries: AM, BH, CD, CG, CR,
1369    DE, DJ, EE, GB, GN, HU, IE, JO, JP, LB, LR, MA, MK, MN, MR, NA, PG, SC, SG, SO, SZ, VN, ZA, ZW
1370  - Data added for the following countries: BZ, CU, EC, FO, GI, HN, HT, LK, MT, MV, NU, PS, SD
1371  - Indentation fixes in reg-exes for the following countries: BG, GB
1372  - Allow nationalPrefixForParsing to be specified for countries with no national prefix, to handle
1373    possible carrier prefixes
1374
1375Jan 3rd, 2011
1376* Metadata changes:
1377  - Updates to JE
1378  - Updated comments for GB/GG/IM/JE
1379
1380November 25th, 2010
1381* Metadata changes:
1382  - Updates to existing countries: AD, AG, AI, AN, AS, BB, BG, BM, BS, BW, CA, DM, DO, GD, GH, GM,
1383    GU, IN, JM, KN, KY, KZ, LB, LC, MP, MS, PR, SY, TC, TT, TZ, US, VC, VG, VI.
1384  - Reorganize reg-exes for better readability.
1385  - Updated comments.
1386
1387October 22nd, 2010
1388* Metadata changes:
1389  - Updates to existing countries: AE, GB, GG, IM, JE
1390
1391October 15th, 2010
1392* Code improvements:
1393  - Allowed parsing of numbers that start with "++" or a full-width "+" symbol
1394  - Allowed reg-exes for national and possible number patterns to have white space in them in the
1395    source XML file
1396  - Added a more useful toString method for the phone number proto class
1397* Metadata changes:
1398  - Updates to existing countries: AF, BF, BO, ES, GB, GG, IM, IS, JE, JE, JP, KR, PE, PT, RU, SE,
1399    TT, ZW
1400* Bug fixes:
1401  - Parsing empty strings with invalid region codes no longer throws a null pointer exception
1402
1403September 4th, 2010
1404* Code improvement:
1405  - Added new phone number type: pager
1406* Metadata change:
1407  - update to existing country: GG, IM, JE, RS, RU
1408* Bug fixes:
1409  - ArrayOutOfBoundException in AsYouTypeFormatter.getRememberedPosition()
1410  - AsYouTypeFormatter for UK childline number
1411
1412September 1st, 2010
1413* Bug fix on KZ metadata.
1414
1415August 17th, 2010
1416* Code improvement:
1417  - Refactored BuildMetadataProtoFromXml.java into BuildMetadataFromXml.java and
1418    BuildMetadataProtoFromXml.java
1419  - Added BuildMetadataProtoFromXml.java and JSArrayBuilder.java
1420  - Refactored CountryCodeToRegionCodeMap and CountryCodeToRegionCodeMapForTesting into separate
1421    files.
1422
1423August 16th, 2010
1424* Bug fixes
1425  - AsYouTypeFormatter for formatting Chinese geographical numbers entered in national format.
1426  - AsYouTypeFormatter for formatting Chinese 400/800 numbers entered in national format.
1427* Metadata change:
1428  - new countries: AM, AN, BH, GL, IS
1429  - adding national prefix 1 to all NANPA countries.
1430  - update to existing countries: BF, FR, UK, PK, RE
1431
1432August 4th, 2010
1433* Further improve startup performance
1434  - Preload no country specific metadata at startup.
1435  - Stop creating the file containing mapping from country calling code to region code and loading
1436    it at startup; instead, do the initialization in PhoneNumberUtil.
1437
1438July 31th, 2010
1439
1440* Improve startup performance
1441  - Separate generated metadata binary file to one file per region
1442  - Preload US at start up, and load other region at the time when needed
1443  - Create a file containing mapping from country calling code to region code, and load it at
1444    startup
1445  - Same change also applied to unittests
1446
1447July 30th, 2010
1448* Metadata change:
1449  - new country: TL
1450  - update to existing country: AZ, CN, FR, GH, JO, LA, PG, PK, QA, SZ, UA, VN
1451
1452* Code improvement
1453  - China local number formatting for AsYouTypeFormatter
1454  - improve extension parsing to handle number in the form of +1 (645) 123 1234 ext. 910#
1455