Imported Upstream version 1.8.1
[platform/upstream/harfbuzz.git] / NEWS
1 Overview of changes leading to 1.8.1
2 Tuesday, June 12, 2018
3 ====================================
4 - Fix hb-version.h file generation; last two releases went out with wrong ones.
5 - Add correctness bug in hb_set_t operations, introduced in 1.7.7.
6 - Remove HB_SUBSET_BUILTIN build option.  Not necessary.
7
8 Overview of changes leading to 1.8.0
9 Tuesday, June 5, 2018
10 ====================================
11 - Update to Unicode 11.0.0.
12
13
14 Overview of changes leading to 1.7.7
15 Tuesday, June 5, 2018
16 ====================================
17 - Lots of internal changes, but not yet exposed externally.
18 - All HarfBuzz objects are significantly smaller in size now.
19 - Sinhala: Position repha on top of post-consonant, not base.
20   This better matches Windows 10 behavior, which was changed
21   from previous Windows versions.
22 - New build options:
23   o New cpp macro HB_NO_ATEXIT
24   o New cpp macro HB_SUBSET_BUILTIN
25 - Significant libharfbuzz-subset changes. API subject to change.
26 - New API in libharfbuzz:
27
28 +hb_blob_create_from_file()
29 +hb_face_count()
30
31 A hashmap implementation:
32 +hb-map.h
33 +HB_MAP_VALUE_INVALID
34 +hb_map_t
35 +hb_map_create()
36 +hb_map_get_empty()
37 +hb_map_reference()
38 +hb_map_destroy()
39 +hb_map_set_user_data()
40 +hb_map_get_user_data()
41 +hb_map_allocation_successful()
42 +hb_map_clear()
43 +hb_map_is_empty()
44 +hb_map_get_population()
45 +hb_map_set()
46 +hb_map_get()
47 +hb_map_del()
48 +hb_map_has()
49
50
51 Overview of changes leading to 1.7.6
52 Wednesday, March 7, 2018
53 ====================================
54
55 - Fix to hb_set_t binary operations. Ouch.
56 - New experimental harfbuzz-subset library. All of hb-subset.h
57   is experimental right now and API WILL change.
58
59 - New API:
60 hb_blob_copy_writable_or_fail()
61 HB_OT_TAG_BASE
62 hb_set_previous()
63 hb_set_previous_range()
64
65
66 Overview of changes leading to 1.7.5
67 Tuesday, January 30, 2018
68 ====================================
69
70 - Separate Khmer shaper from Indic.
71 - First stab at AAT morx. Not hooked up.
72 - Misc bug fixes.
73
74
75 Overview of changes leading to 1.7.4
76 Wednesday, December 20, 2017
77 ====================================
78
79 - Fix collect_glyphs() regression caused by hb_set_t changes.
80
81
82 Overview of changes leading to 1.7.3
83 Monday, December 18, 2017
84 ====================================
85
86 - hb_set_t performance tuning and optimizations.
87 - Speed up collect_glyphs() and reject garbage data.
88 - In hb_coretext_font_create() set font point-size (ptem).
89 - Misc fixes.
90
91
92 Overview of changes leading to 1.7.2
93 Monday, December 4, 2017
94 ====================================
95
96 - Optimize hb_set_add_range().
97 - Misc fixes.
98 - New API:
99 hb_coretext_font_create()
100
101
102 Overview of changes leading to 1.7.1
103 Tuesday, November 14, 2017
104 ====================================
105
106 - Fix atexit object destruction regression.
107 - Fix minor integer-overflow.
108
109
110 Overview of changes leading to 1.7.0
111 Monday, November 13, 2017
112 ====================================
113
114 - Minor Indic fixes.
115 - Implement kerning and glyph names in hb-ot-font.
116 - Various DSO optimization re .data and .bss sizes.
117 - Make C++11 optional; build fixes.
118 - Mark all other backends "unsafe-to-break".
119 - Graphite fix.
120
121
122 Overview of changes leading to 1.6.3
123 Thursday, October 26th, 2017
124 ====================================
125
126 - Fix hb_set_t some more.  Should be solid now.
127 - Implement get_glyph_name() for hb-ot-font.
128 - Misc fixes.
129
130
131 Overview of changes leading to 1.6.2
132 Monday, October 23nd, 2017
133 ====================================
134
135 - Yesterday's release had a bad crasher; don't use it.  That's what
136   happens when one works on Sunday...
137   https://github.com/harfbuzz/harfbuzz/issues/578
138 - Build fixes for FreeBSD and Chrome Android.
139
140
141 Overview of changes leading to 1.6.1
142 Sunday, October 22nd, 2017
143 ====================================
144
145 - Don't skip over COMBINING GRAPHEME JOINER when ligating, etc.
146   To be refined: https://github.com/harfbuzz/harfbuzz/issues/554
147 - Faster hb_set_t implementation.
148 - Don't use deprecated ICU API.
149 - Fix undefined-behavior in Myanmar shaper, introduced in 1.6.0
150 - Deprecated API:
151   hb_set_invert()
152
153
154 Overview of changes leading to 1.6.0
155 Friday, October the 13th, 2017
156 ====================================
157
158 - Update to Unicode 10.
159
160 - Various Indic and Universal Shaping Engine fixes as a result of
161   HarfBuzz Hackfest with Jonathan Kew at Web Engines Hackfest at
162   the Igalia offices in A Coruña, Spain.  Thanks Igalia for having
163   us!
164
165 - Implement Unicode Arabic Mark Ordering Algorithm UTR#53.
166
167 - Implement optical sizing / tracking in CoreText backend, using
168   new API hb_font_set_ptem().
169
170 - Allow notifying hb_font_t that underlying FT_Face changed sizing,
171   using new API hb_ft_font_changed().
172
173 - More Graphite backend RTL fixes.
174
175 - Fix caching of variable font shaping plans.
176
177 - hb-view / hb-shape now accept following new arguments:
178
179   o --unicodes: takes a list of hex numbers that represent Unicode
180     codepoints.
181
182 New API:
183 +hb_face_get_table_tags()
184 +hb_font_set_ptem()
185 +hb_font_get_ptem()
186 +hb_ft_font_changed()
187
188
189 Overview of changes leading to 1.5.1
190 Tuesday, September 5, 2017
191 ====================================
192
193 - Fix "unsafe-to-break" in fallback shaping and other corner cases.
194   All our tests pass with --verify now, meaning unsafe-to-break API
195   works as expected.
196 - Add --unicodes to hb-view / hb-shape.
197 - [indic] Treat Consonant_With_Stacker as consonant.  This will need
198   further tweaking.
199 - hb_buffer_diff() tweaks.
200
201
202 Overview of changes leading to 1.5.0
203 Wednesday, August 23, 2017
204 ====================================
205
206 - Misc new API, for appending a buffer to another, and for comparing
207   contents of two buffers for types of differences.
208
209 - New "unsafe-to-break" API.  Can be used to speed up reshaping
210   in line-breaking situations.  Essentially, after shaping, it returns
211   positions in the input string (some of the cluster boundaries) that
212   are "safe to break" in that if the text is segmented at that position
213   and two sides reshaped and concatenated, the shaping result is
214   exactly the same as shaping the text in one piece.
215
216   hb-view and hb-shape and hb-shape now take --verify, which verifies
217   the above property.
218
219   Some corner cases of the implementation are still not quite working.
220   Those will be fixed in subsequent releases.
221
222 - New API:
223
224 hb_buffer_append()
225
226 hb_glyph_flags_t
227 HB_GLYPH_FLAG_UNSAFE_TO_BREAK
228 HB_GLYPH_FLAG_DEFINED
229 hb_glyph_info_get_glyph_flags()
230
231 HB_BUFFER_SERIALIZE_FLAG_GLYPH_FLAGS
232
233 hb_buffer_diff_flags_t
234 HB_BUFFER_DIFF_FLAG_EQUAL
235 HB_BUFFER_DIFF_FLAG_CONTENT_TYPE_MISMATCH
236 HB_BUFFER_DIFF_FLAG_LENGTH_MISMATCH
237 HB_BUFFER_DIFF_FLAG_NOTDEF_PRESENT
238 HB_BUFFER_DIFF_FLAG_DOTTED_CIRCLE_PRESENT
239 HB_BUFFER_DIFF_FLAG_CODEPOINT_MISMATCH
240 HB_BUFFER_DIFF_FLAG_CLUSTER_MISMATCH
241 HB_BUFFER_DIFF_FLAG_GLYPH_FLAGS_MISMATCH
242 HB_BUFFER_DIFF_FLAG_POSITION_MISMATCH
243 hb_buffer_diff
244
245
246 Overview of changes leading to 1.4.8
247 Tuesday, August 8, 2017
248 ====================================
249
250 - Major fix to avar table handling.
251 - Rename hb-shape --show-message to --trace.
252 - Build fixes.
253
254
255 Overview of changes leading to 1.4.7
256 Tuesday, July 18, 2017
257 ====================================
258
259 - Multiple Indic, Tibetan, and Cham fixes.
260 - CoreText: Allow disabling kerning.
261 - Adjust Arabic feature order again.
262 - Misc build fixes.
263
264
265 Overview of changes leading to 1.4.6
266 Sunday, April 23, 2017
267 ====================================
268
269 - Graphite2: Fix RTL positioning issue.
270 - Backlist GDEF of more versions of Padauk and Tahoma.
271 - New, experimental, cmake alternative build system.
272
273
274 Overview of changes leading to 1.4.5
275 Friday, March 10, 2017
276 ====================================
277
278 - Revert "Fix Context lookup application when moving back after a glyph..."
279   This introduced memory access problems.  To be fixed properly soon.
280
281
282 Overview of changes leading to 1.4.4
283 Sunday, March 5, 2017
284 ====================================
285
286 - Fix Context lookup application when moving back after a glyph deletion.
287 - Fix buffer-overrun in Bengali.
288
289
290 Overview of changes leading to 1.4.3
291 Saturday, February 25, 2017
292 ====================================
293
294 - Route Adlam script to Arabic shaper.
295 - Misc fixes.
296 - New API:
297   hb_font_set_face()
298 - Deprecate API:
299   hb_graphite2_font_get_gr_font()
300
301
302 Overview of changes leading to 1.4.2
303 Monday, January 23, 2017
304 ====================================
305
306 - Implement OpenType Font Variation tables avar/fvar/HVAR/VVAR.
307 - hb-shape and hb-view now accept --variations.
308 - New API:
309
310 hb_variation_t
311 hb_variation_from_string()
312 hb_variation_to_string()
313
314 hb_font_set_variations()
315 hb_font_set_var_coords_design()
316 hb_font_get_var_coords_normalized()
317
318 hb-ot-var.h:
319 hb_ot_var_axis_t
320 hb_ot_var_has_data()
321 hb_ot_var_get_axis_count()
322 hb_ot_var_get_axes()
323 hb_ot_var_find_axis()
324 hb_ot_var_normalize_variations()
325 hb_ot_var_normalize_coords()
326
327 - MVAR to be implemented later.  Access to named instances to be
328   implemented later as well.
329
330 - Misc fixes.
331
332
333 Overview of changes leading to 1.4.1
334 Thursday, January 5, 2017
335 ====================================
336
337 - Always build and use UCDN for Unicode data by default.
338   Reduces dependence on version of Unicode data in glib,
339   specially in the Windows bundles we are shipping, which
340   have very old glib.
341
342
343 Overview of changes leading to 1.4.0
344 Thursday, January 5, 2017
345 ====================================
346
347 - Merged "OpenType GX" branch which adds core of support for
348   OpenType 1.8 Font Variations.  To that extent, the relevant
349   new API is:
350
351 New API:
352 hb_font_set_var_coords_normalized()
353
354   with supporting API:
355
356 New API:
357 HB_OT_LAYOUT_NO_VARIATIONS_INDEX
358 hb_ot_layout_table_find_feature_variations()
359 hb_ot_layout_feature_with_variations_get_lookups()
360 hb_shape_plan_create2()
361 hb_shape_plan_create_cached2()
362
363   Currently variations in GSUB/GPOS/GDEF are fully supported,
364   and no other tables are supported.  In particular, fvar/avar
365   are NOT supported, hence the hb_font_set_var_coords_normalized()
366   taking normalized coordinates.  API to take design coordinates
367   will be added in the future.
368
369   HVAR/VVAR/MVAR support will also be added to hb-ot-font in the
370   future.
371
372 - Fix regression in GDEF glyph class processing.
373 - Add decompositions for Chakma, Limbu, and Balinese in USE shaper.
374 - Misc fixes.
375
376
377 Overview of changes leading to 1.3.4
378 Monday, December 5, 2016
379 ====================================
380
381 - Fix vertical glyph origin in hb-ot-font.
382 - Implement CBDT/CBLC color font glyph extents in hb-ot-font.
383
384
385 Overview of changes leading to 1.3.3
386 Wednesday, September 28, 2016
387 ====================================
388
389 - Implement parsing of OpenType MATH table.
390 New API:
391 HB_OT_TAG_MATH
392 HB_OT_MATH_SCRIPT
393 hb_ot_math_constant_t
394 hb_ot_math_kern_t
395 hb_ot_math_glyph_variant_t
396 hb_ot_math_glyph_part_flags_t
397 hb_ot_math_glyph_part_t
398 hb_ot_math_has_data
399 hb_ot_math_get_constant
400 hb_ot_math_get_glyph_italics_correction
401 hb_ot_math_get_glyph_top_accent_attachment
402 hb_ot_math_get_glyph_kerning
403 hb_ot_math_is_glyph_extended_shape
404 hb_ot_math_get_glyph_variants
405 hb_ot_math_get_min_connector_overlap
406 hb_ot_math_get_glyph_assembly
407
408
409 Overview of changes leading to 1.3.2
410 Wednesday, September 27, 2016
411 ====================================
412
413 - Fix build of hb-coretext on older OS X versions.
414
415
416 Overview of changes leading to 1.3.1
417 Wednesday, September 7, 2016
418 ====================================
419
420 - Blacklist bad GDEF of more fonts (Padauk).
421 - More CoreText backend crash fixes with OS X 10.9.5.
422 - Misc fixes.
423
424
425 Overview of changes leading to 1.3.0
426 Thursday, July 21, 2016
427 ====================================
428
429 - Update to Unicode 9.0.0
430 - Move Javanese from Indic shaper to Universal Shaping Engine.
431 - Allow MultipleSubst to delete a glyph (matching Windows engine).
432 - Update Universal Shaping Engine to latest draft from Microsoft.
433 - DirectWrite backend improvements.  Note: this backend is for testing ONLY.
434 - CoreText backend improvements with unreachable fonts.
435 - Implement symbol fonts (cmap 3.0.0) in hb-ft and hb-ot-font.
436 - Blacklist bad GDEF of more fonts (Tahoma & others).
437 - Misc fixes.
438
439
440 Overview of changes leading to 1.2.7
441 Monday, May 2, 2016
442 ====================================
443
444 - Blacklist another version of Times New Roman (Bold) Italic from Windows 7.
445 - Fix Mongolian Free Variation Selectors shaping with certain fonts.
446 - Fix Tibetan shorthand contractions shaping.
447 - Improved list of language tag mappings.
448 - Unbreak build on Windows CE.
449 - Make 'glyf' table loading lazy in hb-ot-font.
450
451
452 Overview of changes leading to 1.2.6
453 Friday, April 8, 2016
454 ====================================
455
456 - Blacklist GDEF table of another set of Times New Roman (Bold) Italic.
457 - DirectWrite backend improvements.  Note: DirectWrite backend is
458   exclusively for our internal testing and should NOT be used in any
459   production system whatsoever.
460
461
462 Overview of changes leading to 1.2.5
463 Monday, April 4, 2016
464 ====================================
465
466 - Fix GDEF mark-filtering-set, which was broken in 1.2.3.
467
468
469 Overview of changes leading to 1.2.4
470 Thursday, March 17, 2016
471 ====================================
472
473 - Synthesize GDEF glyph class for any glyph that does not have one in GDEF.
474   I really hope we don't discover broken fonts that shape badly with this
475   change.
476 - Misc build and other minor fixes.
477 - API changes:
478   - Added HB_NDEBUG.  It's fine for production systems to define this to
479     disable high-overhead debugging checks.  However, I also reduced the
480     overhead of those checks, so it's a non-issue right now.  You can
481     forget it.  Just not defining anything at all is fine.
482
483
484 Overview of changes leading to 1.2.3
485 Thursday, February 25, 2016
486 ====================================
487
488 - Blacklist GDEF table of certain versions of Times New Roman (Bold) Italic,
489   due to bug in glyph class of ASCII double-quote character.  This should
490   address "regression" introduced in 1.2.0 when we switched mark zeroing
491   in most shapers from BY_UNICODE_LATE to BY_GDEF_LATE.
492   This fourth release in a week should finally stablize things...
493
494 - hb-ot-font's get_glyph() implementation saw some optimizations.  Though,
495   might be really hard to measure in real-world situations.
496
497 - Also, two rather small API changes:
498
499 We now disable some time-consuming internal bookkeeping if built with NDEBUG
500 defined.  This is a first time that we use NDEBUG to disable debug code.  If
501 there exist production systems that do NOT want to enable NDEBUG, please let
502 me know and I'll add HB_NDEBUG.
503
504 Added get_nominal_glyph() and get_variation_glyph() instead of get_glyph()
505
506 New API:
507 - hb_font_get_nominal_glyph_func_t
508 - hb_font_get_variation_glyph_func_t
509 - hb_font_funcs_set_nominal_glyph_func()
510 - hb_font_funcs_set_variation_glyph_func()
511 - hb_font_get_nominal_glyph()
512 - hb_font_get_variation_glyph()
513
514 Deprecated API:
515 - hb_font_get_glyph_func_t
516 - hb_font_funcs_set_glyph_func()
517
518 Clients that implement their own font-funcs are encouraged to replace
519 their get_glyph() implementation with a get_nominal_glyph() and
520 get_variation_glyph() pair.  The variation version can assume that
521 variation_selector argument is not zero.  Old (deprecated) functions
522 will continue working indefinitely using internal gymnastics; it is
523 just more efficient to use the new functions.
524
525
526 Overview of changes leading to 1.2.2
527 Wednesday, February 24, 2016
528 ====================================
529
530 - Fix regression with mark positioning with fonts that have
531   non-zero mark advances.  This was introduced in 1.2.0 while
532   trying to make mark and cursive attachments to work together.
533   I have partially reverted that, so this version is much more
534   like what we had before.  All clients who updated to 1.2.0
535   should update to this version.
536
537
538 Overview of changes leading to 1.2.1
539 Tuesday, February 23, 2016
540 ====================================
541
542 - CoreText: Fix bug with wrong scale if font scale was changed later.
543   https://github.com/libass/libass/issues/212
544 - CoreText: Drastically speed up font initialization.
545 - CoreText: Fix tiny leak.
546 - Group ZWJ/ZWNJ with previous syllable under cluster-level=0.
547   https://github.com/harfbuzz/harfbuzz/issues/217
548 - Add test/shaping/README.md about how to add tests to the suite.
549
550
551 Overview of changes leading to 1.2.0
552 Friday, February 19, 2016
553 ====================================
554
555 - Fix various issues (hangs mostly) in case of memory allocation failure.
556 - Change mark zeroing types of most shapers from BY_UNICODE_LATE to
557   BY_GDEF_LATE.  This seems to be what Uniscribe does.
558 - Change mark zeroing of USE shaper from NONE to BY_GDEF_EARLY.  That's
559   what Windows does.
560 - Allow GPOS cursive connection on marks, and fix the interaction with
561   mark attachment.  This work resulted in some changes to how mark
562   attachments work.  See:
563   https://github.com/harfbuzz/harfbuzz/issues/211
564   https://github.com/harfbuzz/harfbuzz/commit/86c68c7a2c971efe8e35b1f1bd99401dc8b688d2
565 - Graphite2 shaper: improved negative advance handling (eg. Nastaliq).
566 - Add nmake-based build system for Windows.
567 - Minor speedup.
568 - Misc. improvements.
569
570
571 Overview of changes leading to 1.1.3
572 Monday, January 11, 2016
573 ====================================
574
575 - Ported Indic shaper to Unicode 8.0 data.
576 - Universal Shaping Engine fixes.
577 - Speed up CoreText shaper when font fallback happens in CoreText.
578 - Documentation improvements, thanks to Khaled Hosny.
579 - Very rough directwrite shaper for testing, thanks to Ebrahim Byagowi.
580 - Misc bug fixes.
581 - New API:
582
583   * Font extents:
584       hb_font_extents_t
585       hb_font_get_font_extents_func_t
586       hb_font_get_font_h_extents_func_t
587       hb_font_get_font_v_extents_func_t
588       hb_font_funcs_set_font_h_extents_func
589       hb_font_funcs_set_font_v_extents_func
590       hb_font_get_h_extents
591       hb_font_get_v_extents
592       hb_font_get_extents_for_direction
593
594   * Buffer message (aka debug):
595       hb_buffer_message_func_t
596       hb_buffer_set_message_func()
597     Actual message protocol to be fleshed out later.
598
599
600 Overview of changes leading to 1.1.2
601 Wednesday, November 26, 2015
602 ====================================
603
604 - Fix badly-broken fallback shaper that affected terminology.
605   https://github.com/harfbuzz/harfbuzz/issues/187
606 - Fix y_scaling in Graphite shaper.
607 - API changes:
608   * An unset glyph_h_origin() function in font-funcs now (sensibly)
609     implies horizontal origin at 0,0.  Ie, the nil callback returns
610     true instead of false.  As such, implementations that have a
611     glyph_h_origin() that simply returns true, can remove that function
612     with HarfBuzz >= 1.1.2.  This results in a tiny speedup.
613
614
615 Overview of changes leading to 1.1.1
616 Wednesday, November 24, 2015
617 ====================================
618
619 - Build fixes, specially for hb-coretext.
620
621
622 Overview of changes leading to 1.1.0
623 Wednesday, November 18, 2015
624 ====================================
625
626 - Implement 'stch' stretch feature for Syriac Abbreviation Mark.
627   https://github.com/harfbuzz/harfbuzz/issues/141
628 - Disable use of decompose_compatibility() callback.
629 - Implement "shaping" of various Unicode space characters, even
630   if the font does not support them.
631   https://github.com/harfbuzz/harfbuzz/issues/153
632 - If font does not support U+2011 NO-BREAK HYPHEN, fallback to
633   U+2010 HYPHEN.
634 - Changes resulting from libFuzzer continuous fuzzing:
635   * Reject font tables that need more than 8 edits,
636   * Bound buffer growth during shaping to 32x,
637   * Fix assertions and other issues at OOM / buffer max-growth.
638 - Misc fixes and optimizations.
639 - API changes:
640   * All fonts created with hb_font_create() now inherit from
641     (ie. have parent) hb_font_get_empty().
642
643
644 Overview of changes leading to 1.0.6
645 Thursday, October 15, 2015
646 ====================================
647
648 - Reduce max nesting level in OT lookups from 8 to 6.
649   Should not affect any real font as far as I know.
650 - Fix memory access issue in ot-font.
651 - Revert default load-flags of fonts created using hb_ft_font_create()
652   back to FT_LOAD_DEFAULT|FT_LOAD_NO_HINTING.  This was changed in
653   last release (1.0.5), but caused major issues, so revert.
654   https://github.com/harfbuzz/harfbuzz/issues/143
655
656
657 Overview of changes leading to 1.0.5
658 Tuesday, October 13, 2015
659 ====================================
660
661 - Fix multiple memory access bugs discovered using libFuzzer.
662   https://github.com/harfbuzz/harfbuzz/issues/139
663   Everyone should upgrade to this version as soon as possible.
664   We now have continuous fuzzing set up, to avoid issues like
665   these creeping in again.
666 - Misc fixes.
667
668 - New API:
669   * hb_font_set_parent().
670   * hb_ft_font_[sg]et_load_flags()
671     The default flags for fonts created using hb_ft_font_create()
672     has changed to default to FT_LOAD_DEFAULT now.  Previously it
673     was defaulting to FT_LOAD_DFEAULT|FT_LOAD_NO_HINTING.
674
675 - API changes:
676   * Fonts now default to units-per-EM as their scale, instead of 0.
677   * hb_font_create_sub_font() does NOT make parent font immutable
678     anymore.  hb_font_make_immutable() does.
679
680
681 Overview of changes leading to 1.0.4
682 Wednesday, September 30, 2015
683 ====================================
684
685 - Fix minor out-of-bounds read error.
686
687
688 Overview of changes leading to 1.0.3
689 Tuesday, September 1, 2015
690 ====================================
691
692 - Start of user documentation, from Simon Cozens!
693 - Implement glyph_extents() for TrueType fonts in hb-ot-font.
694 - Improve GPOS cursive attachments with conflicting lookups.
695 - More fixes for cluster-level = 1.
696 - Uniscribe positioning fix.
697
698
699 Overview of changes leading to 1.0.2
700 Wednesday, August 19, 2015
701 ====================================
702
703 - Fix shaping with cluster-level > 0.
704 - Fix Uniscribe backend font-size scaling.
705 - Declare dependencies in harfbuzz.pc.
706   FreeType is not declared though, to avoid bugs in pkg-config
707   0.26 with recursive dependencies.
708 - Slightly improved debug infrastructure.  More to come later.
709 - Misc build fixes.
710
711
712 Overview of changes leading to 1.0.1
713 Monday, July 27, 2015
714 ====================================
715
716 - Fix out-of-bounds access in USE shaper.
717
718
719 Overview of changes leading to 1.0.0
720 Sunday, July 26, 2015
721 ====================================
722
723 - Implement Universal Shaping Engine:
724   https://www.microsoft.com/typography/OpenTypeDev/USE/intro.htm
725   http://blogs.windows.com/bloggingwindows/2015/02/23/windows-shapes-the-worlds-languages/
726 - Bump version to 1.0.0.  The soname was NOT bumped.
727
728
729 Overview of changes leading to 0.9.42
730 Thursday, July 26, 2015
731 =====================================
732
733 - New API to allow for retrieving finer-grained cluster
734   mappings if the client desires to handle them.  Default
735   behavior is unchanged.
736 - Fix cluster merging when removing default-ignorables.
737 - Update to Unicode 8.0
738 - hb-graphite2 fixes.
739 - Misc fixes.
740 - Removed HB_NO_MERGE_CLUSTERS hack.
741 - New API:
742   hb_buffer_cluster_level_t enum
743   hb_buffer_get_cluster_level()
744   hb_buffer_set_cluster_level()
745   hb-shape / hb-view --cluster-level
746
747
748 Overview of changes leading to 0.9.41
749 Thursday, June 18, 2015
750 =====================================
751
752 - Fix hb-coretext with trailing whitespace in right-to-left.
753 - New API: hb_buffer_reverse_range().
754 - Allow implementing atomic ops in config.h.
755 - Fix hb_language_t in language bindings.
756 - Misc fixes.
757
758
759 Overview of changes leading to 0.9.40
760 Friday, March 20, 2015
761 =====================================
762
763 - Another hb-coretext crasher fix.  Ouch!
764 - Happy Norouz!
765
766
767 Overview of changes leading to 0.9.39
768 Wednesday, March 4, 2015
769 =====================================
770
771 - Critical hb-coretext fixes.
772 - Optimizations and refactoring; no functional change
773   expected.
774 - Misc build fixes.
775
776
777 Overview of changes leading to 0.9.38
778 Friday, January 23, 2015
779 =====================================
780
781 - Fix minor out-of-bounds access in Indic shaper.
782 - Change New Tai Lue shaping engine from South-East Asian to default,
783   reflecting change in Unicode encoding model.
784 - Add hb-shape --font-size.  Can take up to two numbers for separate
785   x / y size.
786 - Fix CoreText and FreeType scale issues with negative scales.
787 - Reject blobs larger than 2GB.  This might break some icu-le-hb clients
788   that need security fixes.  See:
789   http://www.icu-project.org/trac/ticket/11450
790 - Avoid accessing font tables during face destruction, in casce rogue
791   clients released face data already.
792 - Fix up gobject-introspection a bit.  Python bindings kinda working.
793   See README.python.
794 - Misc fixes.
795 - API additions:
796   hb_ft_face_create_referenced()
797   hb_ft_font_create_referenced()
798
799
800 Overview of changes leading to 0.9.37
801 Wednesday, December 17, 2014
802 =====================================
803
804 - Fix out-of-bounds access in Context lookup format 3.
805 - Indic: Allow ZWJ/ZWNJ before syllable modifiers.
806
807
808 Overview of changes leading to 0.9.36
809 Thursday, November 20, 2014
810 =====================================
811
812 - First time that three months went by without a release since
813   0.9.2 was released on August 10, 2012!
814 - Fix performance bug in hb_ot_collect_glyphs():
815   https://bugzilla.mozilla.org/show_bug.cgi?id=1090869
816 - Add basic vertical-text support to hb-ot-font.
817 - Misc build fixes.
818
819
820 Overview of changes leading to 0.9.35
821 Saturday, August 13, 2014
822 =====================================
823
824 - Fix major shape-plan caching bug when more than one shaper were
825   provided to hb_shape_full() (as exercised by XeTeX).
826   http://www.mail-archive.com/debian-bugs-dist@lists.debian.org/msg1246370.html
827 - Fix Arabic fallback shaping regression.  This was broken in 0.9.32.
828 - Major hb-coretext fixes.  That backend is complete now, including
829   respecing buffer direction and language, down to vertical writing.
830 - Build fixes for Windows CE.  Should build fine now.
831 - Misc fixes:
832   Use atexit() only if it's safe to call from shared library
833   https://bugs.freedesktop.org/show_bug.cgi?id=82246
834   Mandaic had errors in its Unicode Joining_Type
835   https://bugs.freedesktop.org/show_bug.cgi?id=82306
836 - API changes:
837
838   * hb_buffer_clear_contents() does not reset buffer flags now.
839
840     After 763e5466c0a03a7c27020e1e2598e488612529a7, one doesn't
841     need to set flags for different pieces of text.  The flags now
842     are something the client sets up once, depending on how it
843     actually uses the buffer.  As such, don't clear it in
844     clear_contents().
845
846     I don't expect any changes to be needed to any existing client.
847
848
849 Overview of changes leading to 0.9.34
850 Saturday, August 2, 2014
851 =====================================
852
853 - hb_feature_from_string() now accepts CSS font-feature-settings format.
854 - As a result, hb-shape / hb-view --features also accept CSS-style strings.
855   Eg, "'liga' off" is accepted now.
856 - Add old-spec Myanmar shaper:
857   https://bugs.freedesktop.org/show_bug.cgi?id=81775
858 - Don't apply 'calt' in Hangul shaper.
859 - Fix mark advance zeroing for Hebrew shaper:
860   https://bugs.freedesktop.org/show_bug.cgi?id=76767
861 - Implement Windows-1256 custom Arabic shaping.  Only built on Windows,
862   and requires help from get_glyph().  Used by Firefox.
863   https://bugzilla.mozilla.org/show_bug.cgi?id=1045139
864 - Disable 'liga' in vertical text.
865 - Build fixes.
866 - API changes:
867
868   * Make HB_BUFFER_FLAG_BOT/EOT easier to use.
869
870     Previously, we expected users to provide BOT/EOT flags when the
871     text *segment* was at paragraph boundaries.  This meant that for
872     clients that provide full paragraph to HarfBuzz (eg. Pango), they
873     had code like this:
874
875       hb_buffer_set_flags (hb_buffer,
876                            (item_offset == 0 ? HB_BUFFER_FLAG_BOT : 0) |
877                            (item_offset + item_length == paragraph_length ?
878                             HB_BUFFER_FLAG_EOT : 0));
879
880       hb_buffer_add_utf8 (hb_buffer,
881                           paragraph_text, paragraph_length,
882                           item_offset, item_length);
883
884     After this change such clients can simply say:
885
886       hb_buffer_set_flags (hb_buffer,
887                            HB_BUFFER_FLAG_BOT | HB_BUFFER_FLAG_EOT);
888
889       hb_buffer_add_utf8 (hb_buffer,
890                           paragraph_text, paragraph_length,
891                           item_offset, item_length);
892
893     Ie, HarfBuzz itself checks whether the segment is at the beginning/end
894     of the paragraph.  Clients that only pass item-at-a-time to HarfBuzz
895     continue not setting any flags whatsoever.
896
897     Another way to put it is: if there's pre-context text in the buffer,
898     HarfBuzz ignores the BOT flag.  If there's post-context, it ignores
899     EOT flag.
900
901
902 Overview of changes leading to 0.9.33
903 Tuesday, July 22, 2014
904 =====================================
905
906 - Turn off ARabic 'cswh' feature that was accidentally turned on.
907 - Add HB_TAG_MAX_SIGNED.
908 - Make hb_face_make_immutable() really make face immutable!
909 - Windows build fixes.
910
911
912 Overview of changes leading to 0.9.32
913 Thursday, July 17, 2014
914 =====================================
915
916 - Apply Arabic shaping features in spec order exactly.
917 - Another fix for Mongolian free variation selectors.
918 - For non-Arabic scripts in Arabic shaper apply 'rlig' and 'calt'
919   together.
920 - Minor adjustment to U+FFFD logic.
921 - Fix hb-coretext build.
922
923
924 Overview of changes leading to 0.9.31
925 Wednesday, July 16, 2014
926 =====================================
927
928 - Only accept valid UTF-8/16/32; we missed many cases before.
929 - Better shaping of invalid UTF-8/16/32.  Falls back to
930   U+FFFD REPLACEMENT CHARACTER now.
931 - With all changes in this release, the buffer will contain fully
932   valid Unicode after hb_buffer_add_utf8/16/32 no matter how
933   broken the input is.  This can be overridden though.  See below.
934 - Fix Mongolian Variation Selectors for fonts without GDEF.
935 - Fix minor invalid buffer access.
936 - Accept zh-Hant and zh-Hans language tags.  hb_ot_tag_to_language()
937   now uses these instead of private tags.
938 - Build fixes.
939 - New API:
940   * hb_buffer_add_codepoints().  This does what hb_buffer_add_utf32()
941     used to do, ie. no validity check on the input at all.  add_utf32
942     now replaces invalid Unicode codepoints with the replacement
943     character (see below).
944   * hb_buffer_set_replacement_codepoint()
945   * hb_buffer_get_replacement_codepoint()
946     Previously, in hb_buffer_add_utf8 and hb_buffer_add_utf16, when
947     we detected broken input, we replaced that with (hb_codepoint_t)-1.
948     This has changed to use U+FFFD now, but can be changed using these
949     new API.
950
951
952 Overview of changes leading to 0.9.30
953 Wednesday, July 9, 2014
954 =====================================
955
956 - Update to Unicode 7.0.0:
957   * New scripts Manichaean and Psalter Pahlavi are shaped using
958     Arabic shaper.
959   * All the other new scripts to through the generic shaper for
960     now.
961 - Minor Indic improvements.
962 - Fix graphite2 backend cluster mapping [crasher!]
963 - API changes:
964   * New HB_SCRIPT_* values for Unicode 7.0 scripts.
965   * New function hb_ot_layout_language_get_required_feature().
966 - Build fixes.
967
968
969 Overview of changes leading to 0.9.29
970 Thursday, May 29, 2014
971 =====================================
972
973 - Implement cmap in hb-ot-font.h.  No variation-selectors yet.
974 - Myanmar: Allow MedialYa+Asat.
975 - Various Indic fixes:
976   * Support most characters in Extended Devanagary and Vedic
977     Unicode blocks.
978   * Allow digits and a some punctuation as consonant placeholders.
979 - Build fixes.
980
981
982 Overview of changes leading to 0.9.28
983 Monday, April 28, 2014
984 =====================================
985
986 - Unbreak old-spec Indic shaping. (bug 76705)
987 - Fix shaping of U+17DD and U+0FC6.
988 - Add HB_NO_MERGE_CLUSTERS build option.  NOT to be enabled by default
989   for shipping libraries.  It's an option for further experimentation
990   right now.  When we are sure how to do it properly, we will add
991   public run-time API for the functionality.
992 - Build fixes.
993
994
995 Overview of changes leading to 0.9.27
996 Tuesday, March 18, 2014
997 =====================================
998
999 - Don't use "register" storage class specifier
1000 - Wrap definition of free_langs() with HAVE_ATEXIT
1001 - Add coretext_aat shaper and hb_coretext_face_create() constructor
1002 - If HAVE_ICU_BUILTIN is defined, use hb-icu Unicode callbacks
1003 - Add Myanmar test case from OpenType Myanmar spec
1004 - Only do fallback Hebrew composition if no GPOS 'mark' available
1005 - Allow bootstrapping without gtk-doc
1006 - Use AM_MISSING_PROG for ragel and git
1007 - Typo in ucdn's Makefile.am
1008 - Improve MemoryBarrier() implementation
1009
1010
1011 Overview of changes leading to 0.9.26
1012 Thursday, January 30, 2014
1013 =====================================
1014
1015 - Misc fixes.
1016 - Fix application of 'rtlm' feature.
1017 - Automatically apply frac/numr/dnom around U+2044 FRACTION SLASH.
1018 - New header: hb-ot-shape.h
1019 - Uniscribe: fix scratch-buffer accounting.
1020 - Reorder Tai Tham SAKOT to after tone-marks.
1021 - Add Hangul shaper.
1022 - New files:
1023   hb-ot-shape-complex-hangul.cc
1024   hb-ot-shape-complex-hebrew.cc
1025   hb-ot-shape-complex-tibetan.cc
1026 - Disable 'cswh' feature in Arabic shaper.
1027 - Coretext: better handle surrogate pairs.
1028 - Add HB_TAG_MAX and _HB_SCRIPT_MAX_VALUE.
1029
1030
1031 Overview of changes leading to 0.9.25
1032 Wednesday, December 4, 2013
1033 =====================================
1034
1035 - Myanmar shaper improvements.
1036 - Avoid font fallback in CoreText backend.
1037 - Additional OpenType language tag mappiongs.
1038 - More aggressive shape-plan caching.
1039 - Build with / require automake 1.13.
1040 - Build with libtool 2.4.2.418 alpha to support ppc64le.
1041
1042
1043 Overview of changes leading to 0.9.24
1044 Tuesday, November 13, 2013
1045 =====================================
1046
1047 - Misc compiler warning fixes with clang.
1048 - No functional changes.
1049
1050
1051 Overview of changes leading to 0.9.23
1052 Monday, October 28, 2013
1053 =====================================
1054
1055 - "Udupi HarfBuzz Hackfest", Paris, October 14..18 2013.
1056 - Fix (Chain)Context recursion with non-monotone lookup positions.
1057 - Misc Indic bug fixes.
1058 - New Javanese / Buginese shaping, similar to Windows 8.1.
1059
1060
1061 Overview of changes leading to 0.9.22
1062 Thursday, October 3, 2013
1063 =====================================
1064
1065 - Fix use-after-end-of-scope in hb_language_from_string().
1066 - Fix hiding of default_ignorables if font doesn't have space glyph.
1067 - Protect against out-of-range lookup indices.
1068
1069 - API Changes:
1070
1071   * Added hb_ot_layout_table_get_lookup_count()
1072
1073
1074 Overview of changes leading to 0.9.21
1075 Monday, September 16, 2013
1076 =====================================
1077
1078 - Rename gobject-introspection library name from harfbuzz to HarfBuzz.
1079 - Remove (long disabled) hb-old and hb-icu-le test shapers.
1080 - Misc gtk-doc and gobject-introspection annotations.
1081 - Misc fixes.
1082 - API changes:
1083
1084   * Add HB_SET_VALUE_INVALID
1085
1086 Overview of changes leading to 0.9.20
1087 Thursday, August 29, 2013
1088 =====================================
1089
1090 General:
1091 - Misc substitute_closure() fixes.
1092 - Build fixes.
1093
1094 Documentation:
1095 - gtk-doc boilerplate integrated.  Docs are built now, but
1096   contain no contents.  By next release hopefully we have
1097   some content in.  Enable using --enable-gtk-doc.
1098
1099 GObject and Introspection:
1100 - Added harfbuzz-gobject library (hb-gobject.h) that has type
1101   bindings for all HarfBuzz objects and enums.  Enable using
1102   --with-gobject.
1103 - Added gobject-introspection boilerplate.  Nothing useful
1104   right now.  Work in progress.  Gets enabled automatically if
1105   --with-gobject is used.  Override with --disable-introspection.
1106
1107 OpenType shaper:
1108 - Apply 'mark' in Myanmar shaper.
1109 - Don't apply 'dlig' by default.
1110
1111 Uniscribe shaper:
1112 - Support user features.
1113 - Fix loading of fonts that are also installed on the system.
1114 - Fix shaping of Arabic Presentation Forms.
1115 - Fix build with wide chars.
1116
1117 CoreText shaper:
1118 - Support user features.
1119
1120 Source changes:
1121 - hb_face_t code moved to hb-face.h / hb-face.cc.
1122 - Added hb-deprecated.h.
1123
1124 API changes:
1125 - Added HB_DISABLE_DEPRECATED.
1126 - Deprecated HB_SCRIPT_CANADIAN_ABORIGINAL; replaced by
1127   HB_SCRIPT_CANADIAN_SYLLABICS.
1128 - Deprecated HB_BUFFER_FLAGS_DEFAULT; replaced by
1129   HB_BUFFER_FLAG_DEFAULT.
1130 - Deprecated HB_BUFFER_SERIALIZE_FLAGS_DEFAULT; replaced by
1131   HB_BUFFER_SERIALIZE_FLAG_DEFAULT.
1132
1133
1134 Overview of changes leading to 0.9.19
1135 Tuesday, July 16, 2013
1136 =====================================
1137
1138 - Build fixes.
1139 - Better handling of multiple variation selectors in a row.
1140 - Pass on variation selector to GSUB if not consumed by cmap.
1141 - Fix undefined memory access.
1142 - Add Javanese config to Indic shaper.
1143 - Misc bug fixes.
1144
1145 Overview of changes leading to 0.9.18
1146 Tuesday, May 28, 2013
1147 =====================================
1148
1149 New build system:
1150
1151 - All unneeded code is all disabled by default,
1152
1153 - Uniscribe and CoreText shapers can be enabled with their --with options,
1154
1155 - icu_le and old shapers cannot be enabled for now,
1156
1157 - glib, freetype, and cairo will be detected automatically.
1158   They can be force on/off'ed with their --with options,
1159
1160 - icu and graphite2 are default off, can be enabled with their --with
1161   options,
1162
1163 Moreover, ICU support is now build into a separate library:
1164 libharfbuzz-icu.so, and a new harfbuzz-icu.pc is shipped for it.
1165 Distros can enable ICU now without every application on earth
1166 getting linked to via libharfbuzz.so.
1167
1168 For distros I recommend that they make sure they are building --with-glib
1169 --with-freetype --with-cairo, --with-icu, and optionally --with-graphite2;
1170 And package harfbuzz and harfbuzz-icu separately.
1171
1172
1173 Overview of changes leading to 0.9.17
1174 Monday, May 20, 2013
1175 =====================================
1176
1177 - Build fixes.
1178 - Fix bug in hb_set_get_min().
1179 - Fix regression with Arabic mark positioning / width-zeroing.
1180
1181 Overview of changes leading to 0.9.16
1182 Friday, April 19, 2013
1183 =====================================
1184
1185 - Major speedup in OpenType lookup processing.  With the Amiri
1186   Arabic font, this release is over 3x faster than previous
1187   release.  All scripts / languages should see this speedup.
1188
1189 - New --num-iterations option for hb-shape / hb-view; useful for
1190   profiling.
1191
1192 Overview of changes leading to 0.9.15
1193 Friday, April 05, 2013
1194 =====================================
1195
1196 - Build fixes.
1197 - Fix crasher in graphite2 shaper.
1198 - Fix Arabic mark width zeroing regression.
1199 - Don't compose Hangul jamo into Unicode syllables.
1200
1201
1202 Overview of changes leading to 0.9.14
1203 Thursday, March 21, 2013
1204 =====================================
1205
1206 - Build fixes.
1207 - Fix time-consuming sanitize with malicious fonts.
1208 - Implement hb_buffer_deserialize_glyphs() for both json and text.
1209 - Do not ignore Hangul filler characters.
1210 - Indic fixes:
1211   * Fix Malayalam pre-base reordering interaction with post-forms.
1212   * Further adjust ZWJ handling.  Should fix known regressions from
1213     0.9.13.
1214
1215
1216 Overview of changes leading to 0.9.13
1217 Thursday, February 25, 2013
1218 =====================================
1219
1220 - Build fixes.
1221 - Ngapi HarfBuzz Hackfest in London (February 2013):
1222   * Fixed all known Indic bugs,
1223   * New Win8-style Myanmar shaper,
1224   * New South-East Asian shaper for Tai Tham, Cham, and New Tai Lue,
1225   * Smartly ignore Default_Ignorable characters (joiners, etc) wheb
1226     matching GSUB/GPOS lookups,
1227   * Fix 'Phags-Pa U+A872 shaping,
1228   * Fix partial disabling of default-on features,
1229   * Allow disabling of TrueType kerning.
1230 - Fix possible crasher with broken fonts with overlapping tables.
1231 - Removed generated files from git again.  So, one needs ragel to
1232   bootstrap from the git tree.
1233
1234 API changes:
1235 - hb_shape() and related APIs now abort if buffer direction is
1236   HB_DIRECTION_INVALID.  Previously, hb_shape() was calling
1237   hb_buffer_guess_segment_properties() on the buffer before
1238   shaping.  The heuristics in that function are fragile.  If the
1239   user really wants the old behvaior, they can call that function
1240   right before calling hb_shape() to get the old behavior.
1241 - hb_blob_create_sub_blob() always creates sub-blob with
1242   HB_MEMORY_MODE_READONLY.  See comments for the reason.
1243
1244
1245 Overview of changes leading to 0.9.12
1246 Thursday, January 18, 2013
1247 =====================================
1248
1249 - Build fixes for Sun compiler.
1250 - Minor bug fix.
1251
1252 Overview of changes leading to 0.9.11
1253 Thursday, January 10, 2013
1254 =====================================
1255
1256 - Build fixes.
1257 - Fix GPOS mark attachment with null Anchor offsets.
1258 - [Indic] Fix old-spec reordering of viramas if sequence ends in one.
1259 - Fix multi-threaded shaper data creation crash.
1260 - Add atomic ops for Solaris.
1261
1262 API changes:
1263 - Rename hb_buffer_clear() to hb_buffer_clear_contents().
1264
1265
1266 Overview of changes leading to 0.9.10
1267 Thursday, January 3, 2013
1268 =====================================
1269
1270 - [Indic] Fixed rendering of Malayalam dot-reph
1271 - Updated OT language tags.
1272 - Updated graphite2 backend.
1273 - Improved hb_ot_layout_get_size_params() logic.
1274 - Improve hb-shape/hb-view help output.
1275 - Fixed hb-set.h implementation to not crash.
1276 - Fixed various issues with hb_ot_layout_collect_lookups().
1277 - Various build fixes.
1278
1279 New API:
1280
1281 hb_graphite2_face_get_gr_face()
1282 hb_graphite2_font_get_gr_font()
1283 hb_coretext_face_get_cg_font()
1284
1285 Modified API:
1286
1287 hb_ot_layout_get_size_params()
1288
1289
1290 Overview of changes leading to 0.9.9
1291 Wednesday, December 5, 2012
1292 ====================================
1293
1294 - Fix build on Windows.
1295 - Minor improvements.
1296
1297
1298 Overview of changes leading to 0.9.8
1299 Tuesday, December 4, 2012
1300 ====================================
1301
1302
1303 - Actually implement hb_shape_plan_get_shaper ().
1304 - Make UCDB data tables const.
1305 - Lots of internal refactoring in OTLayout tables.
1306 - Flesh out hb_ot_layout_lookup_collect_glyphs().
1307
1308 New API:
1309
1310 hb_ot_layout_collect_lookups()
1311 hb_ot_layout_get_size_params()
1312
1313
1314 Overview of changes leading to 0.9.7
1315 Sunday, November 21, 2012
1316 ====================================
1317
1318
1319 HarfBuzz "All-You-Can-Eat-Sushi" (aka Vancouver) Hackfest and follow-on fixes.
1320
1321 - Fix Arabic contextual joining using pre-context text.
1322 - Fix Sinhala "split matra" mess.
1323 - Fix Khmer shaping with broken fonts.
1324 - Implement Thai "PUA" shaping for old fonts.
1325 - Do NOT route Kharoshthi script through the Indic shaper.
1326 - Disable fallback positioning for Indic and Thai shapers.
1327 - Misc fixes.
1328
1329
1330 hb-shape / hb-view changes:
1331
1332 - Add --text-before and --text-after
1333 - Add --bot / --eot / --preserve-default-ignorables
1334 - hb-shape --output-format=json
1335
1336
1337 New API:
1338
1339 hb_buffer_clear()
1340
1341 hb_buffer_flags_t
1342
1343 HB_BUFFER_FLAGS_DEFAULT
1344 HB_BUFFER_FLAG_BOT
1345 HB_BUFFER_FLAG_EOT
1346 HB_BUFFER_FLAG_PRESERVE_DEFAULT_IGNORABLES
1347
1348 hb_buffer_set_flags()
1349 hb_buffer_get_flags()
1350
1351 HB_BUFFER_SERIALIZE_FLAGS
1352 hb_buffer_serialize_glyphs()
1353 hb_buffer_deserialize_glyphs()
1354 hb_buffer_serialize_list_formats()
1355
1356 hb_set_add_range()
1357 hb_set_del_range()
1358 hb_set_get_population()
1359 hb_set_next_range()
1360
1361 hb_face_[sg]et_glyph_count()
1362
1363 hb_segment_properties_t
1364 HB_SEGMENT_PROPERTIES_DEFAULT
1365 hb_segment_properties_equal()
1366 hb_segment_properties_hash()
1367
1368 hb_buffer_set_segment_properties()
1369 hb_buffer_get_segment_properties()
1370
1371 hb_ot_layout_glyph_class_t
1372 hb_ot_layout_get_glyph_class()
1373 hb_ot_layout_get_glyphs_in_class()
1374
1375 hb_shape_plan_t
1376 hb_shape_plan_create()
1377 hb_shape_plan_create_cached()
1378 hb_shape_plan_get_empty()
1379 hb_shape_plan_reference()
1380 hb_shape_plan_destroy()
1381 hb_shape_plan_set_user_data()
1382 hb_shape_plan_get_user_data()
1383 hb_shape_plan_execute()
1384 hb_shape_plan_get_shaper()
1385
1386 hb_ot_shape_plan_collect_lookups()
1387
1388
1389 API changes:
1390
1391 - Remove "mask" parameter from hb_buffer_add().
1392 - Rename hb_ot_layout_would_substitute_lookup() and hb_ot_layout_substitute_closure_lookup().
1393 - hb-set.h API const correction.
1394 - Renamed hb_set_min/max() to hb_set_get_min/max().
1395 - Rename hb_ot_layout_feature_get_lookup_indexes() to hb_ot_layout_feature_get_lookups().
1396 - Rename hb_buffer_guess_properties() to hb_buffer_guess_segment_properties().
1397
1398
1399
1400 Overview of changes leading to 0.9.6
1401 Sunday, November 13, 2012
1402 ====================================
1403
1404 - Don't clear pre-context text if no new context is provided.
1405 - Fix ReverseChainingSubstLookup, which was totally borked.
1406 - Adjust output format of hb-shape a bit.
1407 - Include config.h.in in-tree.  Makes it easier for alternate build systems.
1408 - Fix hb_buffer_set_length(buffer, 0) invalid memory allocation.
1409 - Use ICU LayoutEngine's C API instead of C++.  Avoids much headache.
1410 - Drop glyphs for all of Unicode Default_Ignorable characters.
1411 - Misc build fixes.
1412
1413 Arabic shaper:
1414 - Enable 'dlig' and 'mset' features in Arabic shaper.
1415 - Implement 'Phags-pa shaping, improve Mongolian.
1416
1417 Indic shaper:
1418 - Decompose Sinhala split matras the way old HarfBuzz / Pango did.
1419 - Initial support for Consonant Medials.
1420 - Start adding new-style Myanmar shaping.
1421 - Make reph and 'pref' logic introspect the font.
1422 - Route Meetei-Mayek through the Indic shaper.
1423 - Don't apply 'liga' in Indic shaper.
1424 - Improve Malayalam pre-base reordering Ra interaction with Chillus.
1425
1426
1427
1428 Overview of changes leading to 0.9.5
1429 Sunday, October 14, 2012
1430 ====================================
1431
1432 - Synthetic-GSUB Arabic fallback shaping.
1433
1434 - Misc Indic improvements.
1435
1436 - Add build system support for pthread.
1437
1438 - Imported UCDN for in-tree Unicode callbacks implementation.
1439
1440 - Context-aware Arabic joining.
1441
1442 - Misc other fixes.
1443
1444 - New API:
1445
1446   hb_feature_to/from-string()
1447   hb_buffer_[sg]et_content_type()
1448
1449
1450
1451 Overview of changes leading to 0.9.4
1452 Tuesday, Sep 03, 2012
1453 ====================================
1454
1455 - Indic improvements with old-spec Malayalam.
1456
1457 - Better fallback glyph positioning, specially with Thai / Lao marks.
1458
1459 - Implement dotted-circle insertion.
1460
1461 - Better Arabic fallback shaping / ligation.
1462
1463 - Added ICU LayoutEngine backend for testing.  Call it by the 'icu_le' name.
1464
1465 - Misc fixes.
1466
1467
1468
1469 Overview of changes leading to 0.9.3
1470 Friday, Aug 18, 2012
1471 ====================================
1472
1473 - Fixed fallback mark positioning for left-to-right text.
1474
1475 - Improve mark positioning for the remaining combining classes.
1476
1477 - Unbreak Thai and fallback Arabic shaping.
1478
1479 - Port Arabic shaper to shape-plan caching.
1480
1481 - Use new ICU normalizer functions.
1482
1483
1484
1485 Overview of changes leading to 0.9.2
1486 Friday, Aug 10, 2012
1487 ====================================
1488
1489 - Over a thousand commits!  This is the first major release of HarfBuzz.
1490
1491 - HarfBuzz is feature-complete now!  It should be in par, or better, than
1492   both Pango's shapers and old HarfBuzz / Qt shapers.
1493
1494 - New Indic shaper, supporting main Indic scripts, Sinhala, and Khmer.
1495
1496 - Improved Arabic shaper, with fallback Arabic shaping, supporting Arabic,
1497   Sinhala, N'ko, Mongolian, and Mandaic.
1498
1499 - New Thai / Lao shaper.
1500
1501 - Tibetan / Hangul support in the generic shaper.
1502
1503 - Synthetic GDEF support for fonts without a GDEF table.
1504
1505 - Fallback mark positioning for fonts without a GPOS table.
1506
1507 - Unicode normalization shaping heuristic during glyph mapping.
1508
1509 - New experimental Graphite2 backend.
1510
1511 - New Uniscribe backend (primarily for testing).
1512
1513 - New CoreText backend (primarily for testing).
1514
1515 - Major optimization and speedup.
1516
1517 - Test suites and testing infrastructure (work in progress).
1518
1519 - Greatly improved hb-view cmdline tool.
1520
1521 - hb-shape cmdline tool.
1522
1523 - Unicode 6.1 support.
1524
1525 Summary of API changes:
1526
1527 o Changed API:
1528
1529   - Users are expected to only include main header files now (ie. hb.h,
1530     hb-glib.h, hb-ft.h, ...)
1531
1532   - All struct tag names had their initial underscore removed.
1533     Ie. "struct _hb_buffer_t" is "struct hb_buffer_t" now.
1534
1535   - All set_user_data() functions now take a "replace" boolean parameter.
1536
1537   - hb_buffer_create() takes zero arguments now.
1538     Use hb_buffer_pre_allocate() to pre-allocate.
1539
1540   - hb_buffer_add_utf*() now accept -1 for length parameteres,
1541     meaning "nul-terminated".
1542
1543   - hb_direction_t enum values changed.
1544
1545   - All *_from_string() APIs now take a length parameter to allow for
1546     non-nul-terminated strings. A -1 length means "nul-terminated".
1547
1548   - Typedef for hb_language_t changed.
1549
1550   - hb_get_table_func_t renamed to hb_reference_table_func_t.
1551
1552   - hb_ot_layout_table_choose_script()
1553
1554   - Various renames in hb-unicode.h.
1555
1556 o New API:
1557
1558   - hb_buffer_guess_properties()
1559     Automatically called by hb_shape().
1560
1561   - hb_buffer_normalize_glyphs()
1562
1563   - hb_tag_from_string()
1564
1565   - hb-coretext.h
1566
1567   - hb-uniscribe.h
1568
1569   - hb_face_reference_blob()
1570   - hb_face_[sg]et_index()
1571   - hb_face_set_upem()
1572
1573   - hb_font_get_glyph_name_func_t
1574     hb_font_get_glyph_from_name_func_t
1575     hb_font_funcs_set_glyph_name_func()
1576     hb_font_funcs_set_glyph_from_name_func()
1577     hb_font_get_glyph_name()
1578     hb_font_get_glyph_from_name()
1579     hb_font_glyph_to_string()
1580     hb_font_glyph_from_string()
1581
1582   - hb_font_set_funcs_data()
1583
1584   - hb_ft_font_set_funcs()
1585   - hb_ft_font_get_face()
1586
1587   - hb-gobject.h (work in progress)
1588
1589   - hb_ot_shape_glyphs_closure()
1590     hb_ot_layout_substitute_closure_lookup()
1591
1592   - hb-set.h
1593
1594   - hb_shape_full()
1595
1596   - hb_unicode_combining_class_t
1597
1598   - hb_unicode_compose_func_t
1599     hb_unicode_decompose_func_t
1600     hb_unicode_decompose_compatibility_func_t
1601     hb_unicode_funcs_set_compose_func()
1602     hb_unicode_funcs_set_decompose_func()
1603     hb_unicode_funcs_set_decompose_compatibility_func()
1604     hb_unicode_compose()
1605     hb_unicode_decompose()
1606     hb_unicode_decompose_compatibility()
1607
1608 o Removed API:
1609
1610   - hb_ft_get_font_funcs()
1611
1612   - hb_ot_layout_substitute_start()
1613     hb_ot_layout_substitute_lookup()
1614     hb_ot_layout_substitute_finish()
1615     hb_ot_layout_position_start()
1616     hb_ot_layout_position_lookup()
1617     hb_ot_layout_position_finish()
1618
1619
1620
1621 Overview of changes leading to 0.6.0
1622 Friday, May 27, 2011
1623 ====================================
1624
1625 - Vertical text support in GPOS
1626 - Almost all API entries have unit tests now, under test/
1627 - All thread-safety issues are fixed
1628
1629 Summary of API changes follows.
1630
1631
1632 * Simple Types API:
1633
1634   o New API:
1635     HB_LANGUAGE_INVALID
1636     hb_language_get_default()
1637     hb_direction_to_string()
1638     hb_direction_from_string()
1639     hb_script_get_horizontal_direction()
1640     HB_UNTAG()
1641
1642   o Renamed API:
1643     hb_category_t renamed to hb_unicode_general_category_t
1644
1645   o Changed API:
1646     hb_language_t is a typed pointers now
1647
1648   o Removed API:
1649     HB_TAG_STR()
1650
1651
1652 * Use ISO 15924 tags for hb_script_t:
1653
1654   o New API:
1655     hb_script_from_iso15924_tag()
1656     hb_script_to_iso15924_tag()
1657     hb_script_from_string()
1658
1659   o Changed API:
1660     HB_SCRIPT_* enum members changed value.
1661
1662
1663 * Buffer API streamlined:
1664
1665   o New API:
1666     hb_buffer_reset()
1667     hb_buffer_set_length()
1668     hb_buffer_allocation_successful()
1669
1670   o Renamed API:
1671     hb_buffer_ensure() renamed to hb_buffer_pre_allocate()
1672     hb_buffer_add_glyph() renamed to hb_buffer_add()
1673
1674   o Removed API:
1675     hb_buffer_clear()
1676     hb_buffer_clear_positions()
1677
1678   o Changed API:
1679     hb_buffer_get_glyph_infos() takes an out length parameter now
1680     hb_buffer_get_glyph_positions() takes an out length parameter now
1681
1682
1683 * Blob API streamlined:
1684
1685   o New API:
1686     hb_blob_get_data()
1687     hb_blob_get_data_writable()
1688
1689   o Renamed API:
1690     hb_blob_create_empty() renamed to hb_blob_get_empty()
1691
1692   o Removed API:
1693     hb_blob_lock()
1694     hb_blob_unlock()
1695     hb_blob_is_writable()
1696     hb_blob_try_writable()
1697
1698   o Changed API:
1699     hb_blob_create() takes user_data before destroy now
1700
1701
1702 * Unicode functions API:
1703
1704   o Unicode function vectors can subclass other unicode function vectors now.
1705     Unimplemented callbacks in the subclass automatically chainup to the parent.
1706
1707   o All hb_unicode_funcs_t callbacks take a user_data now.  Their setters
1708     take a user_data and its respective destroy callback.
1709
1710   o New API:
1711     hb_unicode_funcs_get_empty()
1712     hb_unicode_funcs_get_default()
1713     hb_unicode_funcs_get_parent()
1714
1715   o Changed API:
1716     hb_unicode_funcs_create() now takes a parent_funcs.
1717
1718   o Removed func getter functions:
1719     hb_unicode_funcs_get_mirroring_func()
1720     hb_unicode_funcs_get_general_category_func()
1721     hb_unicode_funcs_get_script_func()
1722     hb_unicode_funcs_get_combining_class_func()
1723     hb_unicode_funcs_get_eastasian_width_func()
1724
1725
1726 * Face API:
1727
1728   o Renamed API:
1729     hb_face_get_table() renamed to hb_face_reference_table()
1730     hb_face_create_for_data() renamed to hb_face_create()
1731
1732   o Changed API:
1733     hb_face_create_for_tables() takes user_data before destroy now
1734     hb_face_reference_table() returns empty blob instead of NULL
1735     hb_get_table_func_t accepts the face as first parameter now
1736
1737 * Font API:
1738
1739   o Fonts can subclass other fonts now.  Unimplemented callbacks in the
1740     subclass automatically chainup to the parent.  When chaining up,
1741     scale is adjusted if the parent font has a different scale.
1742
1743   o All hb_font_funcs_t callbacks take a user_data now.  Their setters
1744     take a user_data and its respective destroy callback.
1745
1746   o New API:
1747     hb_font_get_parent()
1748     hb_font_funcs_get_empty()
1749     hb_font_create_sub_font()
1750
1751   o Removed API:
1752     hb_font_funcs_copy()
1753     hb_font_unset_funcs()
1754
1755   o Removed func getter functions:
1756     hb_font_funcs_get_glyph_func()
1757     hb_font_funcs_get_glyph_advance_func()
1758     hb_font_funcs_get_glyph_extents_func()
1759     hb_font_funcs_get_contour_point_func()
1760     hb_font_funcs_get_kerning_func()
1761
1762   o Changed API:
1763     hb_font_create() takes a face and references it now
1764     hb_font_set_funcs() takes user_data before destroy now
1765     hb_font_set_scale() accepts signed integers now
1766     hb_font_get_contour_point_func_t now takes glyph first, then point_index
1767     hb_font_get_glyph_func_t returns a success boolean now
1768
1769
1770 * Changed object model:
1771
1772   o All object types have a _get_empty() now:
1773     hb_blob_get_empty()
1774     hb_buffer_get_empty()
1775     hb_face_get_empty()
1776     hb_font_get_empty()
1777     hb_font_funcs_get_empty()
1778     hb_unicode_funcs_get_empty()
1779
1780   o Added _set_user_data() and _get_user_data() for all object types:
1781     hb_blob_get_user_data()
1782     hb_blob_set_user_data()
1783     hb_buffer_get_user_data()
1784     hb_buffer_set_user_data()
1785     hb_face_get_user_data()
1786     hb_face_set_user_data()
1787     hb_font_funcs_get_user_data()
1788     hb_font_funcs_set_user_data()
1789     hb_font_get_user_data()
1790     hb_font_set_user_data()
1791     hb_unicode_funcs_get_user_data()
1792     hb_unicode_funcs_set_user_data()
1793
1794   o Removed the _get_reference_count() from all object types:
1795     hb_blob_get_reference_count()
1796     hb_buffer_get_reference_count()
1797     hb_face_get_reference_count()
1798     hb_font_funcs_get_reference_count()
1799     hb_font_get_reference_count()
1800     hb_unicode_funcs_get_reference_count()
1801
1802   o Added _make_immutable() and _is_immutable() for all object types except for buffer:
1803     hb_blob_make_immutable()
1804     hb_blob_is_immutable()
1805     hb_face_make_immutable()
1806     hb_face_is_immutable()
1807
1808
1809 * Changed API for vertical text support
1810
1811   o The following callbacks where removed:
1812     hb_font_get_glyph_advance_func_t
1813     hb_font_get_kerning_func_t
1814
1815   o The following new callbacks added instead:
1816     hb_font_get_glyph_h_advance_func_t
1817     hb_font_get_glyph_v_advance_func_t
1818     hb_font_get_glyph_h_origin_func_t
1819     hb_font_get_glyph_v_origin_func_t
1820     hb_font_get_glyph_h_kerning_func_t
1821     hb_font_get_glyph_v_kerning_func_t
1822
1823   o The following API removed as such:
1824     hb_font_funcs_set_glyph_advance_func()
1825     hb_font_funcs_set_kerning_func()
1826     hb_font_get_glyph_advance()
1827     hb_font_get_kerning()
1828
1829   o New API added instead:
1830     hb_font_funcs_set_glyph_h_advance_func()
1831     hb_font_funcs_set_glyph_v_advance_func()
1832     hb_font_funcs_set_glyph_h_origin_func()
1833     hb_font_funcs_set_glyph_v_origin_func()
1834     hb_font_funcs_set_glyph_h_kerning_func()
1835     hb_font_funcs_set_glyph_v_kerning_func()
1836     hb_font_get_glyph_h_advance()
1837     hb_font_get_glyph_v_advance()
1838     hb_font_get_glyph_h_origin()
1839     hb_font_get_glyph_v_origin()
1840     hb_font_get_glyph_h_kerning()
1841     hb_font_get_glyph_v_kerning()
1842
1843   o The following higher-leve API added for convenience:
1844     hb_font_get_glyph_advance_for_direction()
1845     hb_font_get_glyph_origin_for_direction()
1846     hb_font_add_glyph_origin_for_direction()
1847     hb_font_subtract_glyph_origin_for_direction()
1848     hb_font_get_glyph_kerning_for_direction()
1849     hb_font_get_glyph_extents_for_origin()
1850     hb_font_get_glyph_contour_point_for_origin()
1851
1852
1853 * OpenType Layout API:
1854
1855   o New API:
1856     hb_ot_layout_position_start()
1857     hb_ot_layout_substitute_start()
1858     hb_ot_layout_substitute_finish()
1859
1860
1861 * Glue code:
1862
1863   o New API:
1864     hb_glib_script_to_script()
1865     hb_glib_script_from_script()
1866     hb_icu_script_to_script()
1867     hb_icu_script_from_script()
1868
1869
1870 * Version API added:
1871
1872   o New API:
1873     HB_VERSION_MAJOR
1874     HB_VERSION_MINOR
1875     HB_VERSION_MICRO
1876     HB_VERSION_STRING
1877     HB_VERSION_CHECK()
1878     hb_version()
1879     hb_version_string()
1880     hb_version_check()
1881
1882