Fixes crash if an iframe that hasn't swapped starts loading
[chromium-blink-merge.git] / third_party / harfbuzz-ng / NEWS
blobc4950e262096666ca50dfd702a3c961b75311527
1 Overview of changes leading to 0.9.40
2 Friday, March 20, 2015
3 =====================================
5 - Another hb-coretext crasher fix.  Ouch!
6 - Happy Norouz!
9 Overview of changes leading to 0.9.39
10 Wednesday, March 4, 2015
11 =====================================
13 - Critical hb-coretext fixes.
14 - Optimizations and refactoring; no functional change
15   expected.
16 - Misc build fixes.
19 Overview of changes leading to 0.9.38
20 Friday, January 23, 2015
21 =====================================
23 - Fix minor out-of-bounds access in Indic shaper.
24 - Change New Tai Lue shaping engine from South-East Asian to default,
25   reflecting change in Unicode encoding model.
26 - Add hb-shape --font-size.  Can take up to two numbers for separate
27   x / y size.
28 - Fix CoreText and FreeType scale issues with negative scales.
29 - Reject blobs larger than 2GB.  This might break some icu-le-hb clients
30   that need security fixes.  See:
31   http://www.icu-project.org/trac/ticket/11450
32 - Avoid accessing font tables during face destruction, in casce rogue
33   clients released face data already.
34 - Fix up gobject-introspection a bit.  Python bindings kinda working.
35   See README.python.
36 - Misc fixes.
37 - API additions:
38   hb_ft_face_create_referenced()
39   hb_ft_font_create_referenced()
42 Overview of changes leading to 0.9.37
43 Wednesday, December 17, 2014
44 =====================================
46 - Fix out-of-bounds access in Context lookup format 3.
47 - Indic: Allow ZWJ/ZWNJ before syllable modifiers.
50 Overview of changes leading to 0.9.36
51 Thursday, November 20, 2014
52 =====================================
54 - First time that three months went by without a release since
55   0.9.2 was released on August 10, 2012!
56 - Fix performance bug in hb_ot_collect_glyphs():
57   https://bugzilla.mozilla.org/show_bug.cgi?id=1090869
58 - Add basic vertical-text support to hb-ot-font.
59 - Misc build fixes.
62 Overview of changes leading to 0.9.35
63 Saturday, August 13, 2014
64 =====================================
66 - Fix major shape-plan caching bug when more than one shaper were
67   provided to hb_shape_full() (as exercised by XeTeX).
68   http://www.mail-archive.com/debian-bugs-dist@lists.debian.org/msg1246370.html
69 - Fix Arabic fallback shaping regression.  This was broken in 0.9.32.
70 - Major hb-coretext fixes.  That backend is complete now, including
71   respecing buffer direction and language, down to vertical writing.
72 - Build fixes for Windows CE.  Should build fine now.
73 - Misc fixes:
74   Use atexit() only if it's safe to call from shared library
75   https://bugs.freedesktop.org/show_bug.cgi?id=82246
76   Mandaic had errors in its Unicode Joining_Type
77   https://bugs.freedesktop.org/show_bug.cgi?id=82306
78 - API changes:
80   * hb_buffer_clear_contents() does not reset buffer flags now.
82     After 763e5466c0a03a7c27020e1e2598e488612529a7, one doesn't
83     need to set flags for different pieces of text.  The flags now
84     are something the client sets up once, depending on how it
85     actually uses the buffer.  As such, don't clear it in
86     clear_contents().
88     I don't expect any changes to be needed to any existing client.
91 Overview of changes leading to 0.9.34
92 Saturday, August 2, 2014
93 =====================================
95 - hb_feature_from_string() now accepts CSS font-feature-settings format.
96 - As a result, hb-shape / hb-view --features also accept CSS-style strings.
97   Eg, "'liga' off" is accepted now.
98 - Add old-spec Myanmar shaper:
99   https://bugs.freedesktop.org/show_bug.cgi?id=81775
100 - Don't apply 'calt' in Hangul shaper.
101 - Fix mark advance zeroing for Hebrew shaper:
102   https://bugs.freedesktop.org/show_bug.cgi?id=76767
103 - Implement Windows-1256 custom Arabic shaping.  Only built on Windows,
104   and requires help from get_glyph().  Used by Firefox.
105   https://bugzilla.mozilla.org/show_bug.cgi?id=1045139
106 - Disable 'liga' in vertical text.
107 - Build fixes.
108 - API changes:
110   * Make HB_BUFFER_FLAG_BOT/EOT easier to use.
112     Previously, we expected users to provide BOT/EOT flags when the
113     text *segment* was at paragraph boundaries.  This meant that for
114     clients that provide full paragraph to HarfBuzz (eg. Pango), they
115     had code like this:
117       hb_buffer_set_flags (hb_buffer,
118                            (item_offset == 0 ? HB_BUFFER_FLAG_BOT : 0) |
119                            (item_offset + item_length == paragraph_length ?
120                             HB_BUFFER_FLAG_EOT : 0));
122       hb_buffer_add_utf8 (hb_buffer,
123                           paragraph_text, paragraph_length,
124                           item_offset, item_length);
126     After this change such clients can simply say:
128       hb_buffer_set_flags (hb_buffer,
129                            HB_BUFFER_FLAG_BOT | HB_BUFFER_FLAG_EOT);
131       hb_buffer_add_utf8 (hb_buffer,
132                           paragraph_text, paragraph_length,
133                           item_offset, item_length);
135     Ie, HarfBuzz itself checks whether the segment is at the beginning/end
136     of the paragraph.  Clients that only pass item-at-a-time to HarfBuzz
137     continue not setting any flags whatsoever.
139     Another way to put it is: if there's pre-context text in the buffer,
140     HarfBuzz ignores the BOT flag.  If there's post-context, it ignores
141     EOT flag.
144 Overview of changes leading to 0.9.33
145 Tuesday, July 22, 2014
146 =====================================
148 - Turn off ARabic 'cswh' feature that was accidentally turned on.
149 - Add HB_TAG_MAX_SIGNED.
150 - Make hb_face_make_immutable() really make face immutable!
151 - Windows build fixes.
154 Overview of changes leading to 0.9.32
155 Thursday, July 17, 2014
156 =====================================
158 - Apply Arabic shaping features in spec order exactly.
159 - Another fix for Mongolian free variation selectors.
160 - For non-Arabic scripts in Arabic shaper apply 'rlig' and 'calt'
161   together.
162 - Minor adjustment to U+FFFD logic.
163 - Fix hb-coretext build.
166 Overview of changes leading to 0.9.31
167 Wednesday, July 16, 2014
168 =====================================
170 - Only accept valid UTF-8/16/32; we missed many cases before.
171 - Better shaping of invalid UTF-8/16/32.  Falls back to
172   U+FFFD REPLACEMENT CHARACTER now.
173 - With all changes in this release, the buffer will contain fully
174   valid Unicode after hb_buffer_add_utf8/16/32 no matter how
175   broken the input is.  This can be overriden though.  See below.
176 - Fix Mongolian Variation Selectors for fonts without GDEF.
177 - Fix minor invalid buffer access.
178 - Accept zh-Hant and zh-Hans language tags.  hb_ot_tag_to_language()
179   now uses these instead of private tags.
180 - Build fixes.
181 - New API:
182   * hb_buffer_add_codepoints().  This does what hb_buffer_add_utf32()
183     used to do, ie. no validity check on the input at all.  add_utf32
184     now replaces invalid Unicode codepoints with the replacement
185     character (see below).
186   * hb_buffer_set_replacement_codepoint()
187   * hb_buffer_get_replacement_codepoint()
188     Previously, in hb_buffer_add_utf8 and hb_buffer_add_utf16, when
189     we detected broken input, we replaced that with (hb_codepoint_t)-1.
190     This has changed to use U+FFFD now, but can be changed using these
191     new API.
194 Overview of changes leading to 0.9.30
195 Wednesday, July 9, 2014
196 =====================================
198 - Update to Unicode 7.0.0:
199   * New scripts Manichaean and Psalter Pahlavi are shaped using
200     Arabic shaper.
201   * All the other new scripts to through the generic shaper for
202     now.
203 - Minor Indic improvements.
204 - Fix graphite2 backend cluster mapping [crasher!]
205 - API changes:
206   * New HB_SCRIPT_* values for Unicode 7.0 scripts.
207   * New function hb_ot_layout_language_get_required_feature().
208 - Build fixes.
211 Overview of changes leading to 0.9.29
212 Thursday, May 29, 2014
213 =====================================
215 - Implement cmap in hb-ot-font.h.  No variation-selectors yet.
216 - Myanmar: Allow MedialYa+Asat.
217 - Various Indic fixes:
218   * Support most characters in Extended Devanagary and Vedic
219     Unicode blocks.
220   * Allow digits and a some punctuation as consonant placeholders.
221 - Build fixes.
224 Overview of changes leading to 0.9.28
225 Monday, April 28, 2014
226 =====================================
228 - Unbreak old-spec Indic shaping. (bug 76705)
229 - Fix shaping of U+17DD and U+0FC6.
230 - Add HB_NO_MERGE_CLUSTERS build option.  NOT to be enabled by default
231   for shipping libraries.  It's an option for further experimentation
232   right now.  When we are sure how to do it properly, we will add
233   public run-time API for the functionality.
234 - Build fixes.
237 Overview of changes leading to 0.9.27
238 Tuesday, March 18, 2014
239 =====================================
241 - Don't use "register" storage class specifier
242 - Wrap definition of free_langs() with HAVE_ATEXIT
243 - Add coretext_aat shaper and hb_coretext_face_create() constructor
244 - If HAVE_ICU_BUILTIN is defined, use hb-icu Unicode callbacks
245 - Add Myanmar test case from OpenType Myanmar spec
246 - Only do fallback Hebrew composition if no GPOS 'mark' available
247 - Allow bootstrapping without gtk-doc
248 - Use AM_MISSING_PROG for ragel and git
249 - Typo in ucdn's Makefile.am
250 - Improve MemoryBarrier() implementation
253 Overview of changes leading to 0.9.26
254 Thursday, January 30, 2014
255 =====================================
257 - Misc fixes.
258 - Fix application of 'rtlm' feature.
259 - Automatically apply frac/numr/dnom around U+2044 FRACTION SLASH.
260 - New header: hb-ot-shape.h
261 - Uniscribe: fix scratch-buffer accounting.
262 - Reorder Tai Tham SAKOT to after tone-marks.
263 - Add Hangul shaper.
264 - New files:
265   hb-ot-shape-complex-hangul.cc
266   hb-ot-shape-complex-hebrew.cc
267   hb-ot-shape-complex-tibetan.cc
268 - Disable 'cswh' feature in Arabic shaper.
269 - Coretext: better handle surrogate pairs.
270 - Add HB_TAG_MAX and _HB_SCRIPT_MAX_VALUE.
273 Overview of changes leading to 0.9.25
274 Wednesday, December 4, 2013
275 =====================================
277 - Myanmar shaper improvements.
278 - Avoid font fallback in CoreText backend.
279 - Additional OpenType language tag mappiongs.
280 - More aggressive shape-plan caching.
281 - Build with / require automake 1.13.
282 - Build with libtool 2.4.2.418 alpha to support ppc64le.
285 Overview of changes leading to 0.9.24
286 Tuesday, November 13, 2013
287 =====================================
289 - Misc compiler warning fixes with clang.
290 - No functional changes.
293 Overview of changes leading to 0.9.23
294 Monday, October 28, 2013
295 =====================================
297 - "Udupi HarfBuzz Hackfest", Paris, October 14..18 2013.
298 - Fix (Chain)Context recursion with non-monotone lookup positions.
299 - Misc Indic bug fixes.
300 - New Javanese / Buginese shaping, similar to Windows 8.1.
303 Overview of changes leading to 0.9.22
304 Thursday, October 3, 2013
305 =====================================
307 - Fix use-after-end-of-scope in hb_language_from_string().
308 - Fix hiding of default_ignorables if font doesn't have space glyph.
309 - Protect against out-of-range lookup indices.
311 - API Changes:
313   * Added hb_ot_layout_table_get_lookup_count()
316 Overview of changes leading to 0.9.21
317 Monday, September 16, 2013
318 =====================================
320 - Rename gobject-introspection library name from harfbuzz to HarfBuzz.
321 - Remove (long disabled) hb-old and hb-icu-le test shapers.
322 - Misc gtk-doc and gobject-introspection annotations.
323 - Misc fixes.
324 - API changes:
326   * Add HB_SET_VALUE_INVALID
328 Overview of changes leading to 0.9.20
329 Thursday, August 29, 2013
330 =====================================
332 General:
333 - Misc substitute_closure() fixes.
334 - Build fixes.
336 Documentation:
337 - gtk-doc boilerplate integrated.  Docs are built now, but
338   contain no contents.  By next release hopefully we have
339   some content in.  Enable using --enable-gtk-doc.
341 GObject and Introspection:
342 - Added harfbuzz-gobject library (hb-gobject.h) that has type
343   bindings for all HarfBuzz objects and enums.  Enable using
344   --with-gobject.
345 - Added gobject-introspection boilerplate.  Nothing useful
346   right now.  Work in progress.  Gets enabled automatically if
347   --with-gobject is used.  Override with --disable-introspection.
349 OpenType shaper:
350 - Apply 'mark' in Myanmar shaper.
351 - Don't apply 'dlig' by default.
353 Uniscribe shaper:
354 - Support user features.
355 - Fix loading of fonts that are also installed on the system.
356 - Fix shaping of Arabic Presentation Forms.
357 - Fix build with wide chars.
359 CoreText shaper:
360 - Support user features.
362 Source changes:
363 - hb_face_t code moved to hb-face.h / hb-face.cc.
364 - Added hb-deprecated.h.
366 API changes:
367 - Added HB_DISABLE_DEPRECATED.
368 - Deprecated HB_SCRIPT_CANADIAN_ABORIGINAL; replaced by
369   HB_SCRIPT_CANADIAN_SYLLABICS.
370 - Deprecated HB_BUFFER_FLAGS_DEFAULT; replaced by
371   HB_BUFFER_FLAG_DEFAULT.
372 - Deprecated HB_BUFFER_SERIALIZE_FLAGS_DEFAULT; replaced by
373   HB_BUFFER_SERIALIZE_FLAG_DEFAULT.
376 Overview of changes leading to 0.9.19
377 Tuesday, July 16, 2013
378 =====================================
380 - Build fixes.
381 - Better handling of multiple variation selectors in a row.
382 - Pass on variation selector to GSUB if not consumed by cmap.
383 - Fix undefined memory access.
384 - Add Javanese config to Indic shaper.
385 - Misc bug fixes.
387 Overview of changes leading to 0.9.18
388 Tuesday, May 28, 2013
389 =====================================
391 New build system:
393 - All unneeded code is all disabled by default,
395 - Uniscribe and CoreText shapers can be enabled with their --with options,
397 - icu_le and old shapers cannot be enabled for now,
399 - glib, freetype, and cairo will be detected automatically.
400   They can be force on/off'ed with their --with options,
402 - icu and graphite2 are default off, can be enabled with their --with
403   options,
405 Moreover, ICU support is now build into a separate library:
406 libharfbuzz-icu.so, and a new harfbuzz-icu.pc is shipped for it.
407 Distros can enable ICU now without every application on earth
408 getting linked to via libharfbuzz.so.
410 For distros I recommend that they make sure they are building --with-glib
411 --with-freetype --with-cairo, --with-icu, and optionally --with-graphite2;
412 And package harfbuzz and harfbuzz-icu separately.
415 Overview of changes leading to 0.9.17
416 Monday, May 20, 2013
417 =====================================
419 - Build fixes.
420 - Fix bug in hb_set_get_min().
421 - Fix regression with Arabic mark positioning / width-zeroing.
423 Overview of changes leading to 0.9.16
424 Friday, April 19, 2013
425 =====================================
427 - Major speedup in OpenType lookup processing.  With the Amiri
428   Arabic font, this release is over 3x faster than previous
429   release.  All scripts / languages should see this speedup.
431 - New --num-iterations option for hb-shape / hb-view; useful for
432   profiling.
434 Overview of changes leading to 0.9.15
435 Friday, April 05, 2013
436 =====================================
438 - Build fixes.
439 - Fix crasher in graphite2 shaper.
440 - Fix Arabic mark width zeroing regression.
441 - Don't compose Hangul jamo into Unicode syllables.
444 Overview of changes leading to 0.9.14
445 Thursday, March 21, 2013
446 =====================================
448 - Build fixes.
449 - Fix time-consuming sanitize with malicious fonts.
450 - Implement hb_buffer_deserialize_glyphs() for both json and text.
451 - Do not ignore Hangul filler characters.
452 - Indic fixes:
453   * Fix Malayalam pre-base reordering interaction with post-forms.
454   * Further adjust ZWJ handling.  Should fix known regressions from
455     0.9.13.
458 Overview of changes leading to 0.9.13
459 Thursday, February 25, 2013
460 =====================================
462 - Build fixes.
463 - Ngapi HarfBuzz Hackfest in London (February 2013):
464   * Fixed all known Indic bugs,
465   * New Win8-style Myanmar shaper,
466   * New South-East Asian shaper for Tai Tham, Cham, and New Tai Lue,
467   * Smartly ignore Default_Ignorable characters (joiners, etc) wheb
468     matching GSUB/GPOS lookups,
469   * Fix 'Phags-Pa U+A872 shaping,
470   * Fix partial disabling of default-on features,
471   * Allow disabling of TrueType kerning.
472 - Fix possible crasher with broken fonts with overlapping tables.
473 - Removed generated files from git again.  So, one needs ragel to
474   bootstrap from the git tree.
476 API changes:
477 - hb_shape() and related APIs now abort if buffer direction is
478   HB_DIRECTION_INVALID.  Previously, hb_shape() was calling
479   hb_buffer_guess_segment_properties() on the buffer before
480   shaping.  The heuristics in that function are fragile.  If the
481   user really wants the old behvaior, they can call that function
482   right before calling hb_shape() to get the old behavior.
483 - hb_blob_create_sub_blob() always creates sub-blob with
484   HB_MEMORY_MODE_READONLY.  See comments for the reason.
487 Overview of changes leading to 0.9.12
488 Thursday, January 18, 2013
489 =====================================
491 - Build fixes for Sun compiler.
492 - Minor bug fix.
494 Overview of changes leading to 0.9.11
495 Thursday, January 10, 2013
496 =====================================
498 - Build fixes.
499 - Fix GPOS mark attachment with null Anchor offsets.
500 - [Indic] Fix old-spec reordering of viramas if sequence ends in one.
501 - Fix multi-threaded shaper data creation crash.
502 - Add atomic ops for Solaris.
504 API changes:
505 - Rename hb_buffer_clear() to hb_buffer_clear_contents().
508 Overview of changes leading to 0.9.10
509 Thursday, January 3, 2013
510 =====================================
512 - [Indic] Fixed rendering of Malayalam dot-reph
513 - Updated OT language tags.
514 - Updated graphite2 backend.
515 - Improved hb_ot_layout_get_size_params() logic.
516 - Improve hb-shape/hb-view help output.
517 - Fixed hb-set.h implementation to not crash.
518 - Fixed various issues with hb_ot_layout_collect_lookups().
519 - Various build fixes.
521 New API:
523 hb_graphite2_face_get_gr_face()
524 hb_graphite2_font_get_gr_font()
525 hb_coretext_face_get_cg_font()
527 Modified API:
529 hb_ot_layout_get_size_params()
532 Overview of changes leading to 0.9.9
533 Wednesday, December 5, 2012
534 ====================================
536 - Fix build on Windows.
537 - Minor improvements.
540 Overview of changes leading to 0.9.8
541 Tuesday, December 4, 2012
542 ====================================
545 - Actually implement hb_shape_plan_get_shaper ().
546 - Make UCDB data tables const.
547 - Lots of internal refactoring in OTLayout tables.
548 - Flesh out hb_ot_layout_lookup_collect_glyphs().
550 New API:
552 hb_ot_layout_collect_lookups()
553 hb_ot_layout_get_size_params()
556 Overview of changes leading to 0.9.7
557 Sunday, November 21, 2012
558 ====================================
561 HarfBuzz "All-You-Can-Eat-Sushi" (aka Vancouver) Hackfest and follow-on fixes.
563 - Fix Arabic contextual joining using pre-context text.
564 - Fix Sinhala "split matra" mess.
565 - Fix Khmer shaping with broken fonts.
566 - Implement Thai "PUA" shaping for old fonts.
567 - Do NOT route Kharoshthi script through the Indic shaper.
568 - Disable fallback positioning for Indic and Thai shapers.
569 - Misc fixes.
572 hb-shape / hb-view changes:
574 - Add --text-before and --text-after
575 - Add --bot / --eot / --preserve-default-ignorables
576 - hb-shape --output-format=json
579 New API:
581 hb_buffer_clear()
583 hb_buffer_flags_t
585 HB_BUFFER_FLAGS_DEFAULT
586 HB_BUFFER_FLAG_BOT
587 HB_BUFFER_FLAG_EOT
588 HB_BUFFER_FLAG_PRESERVE_DEFAULT_IGNORABLES
590 hb_buffer_set_flags()
591 hb_buffer_get_flags()
593 HB_BUFFER_SERIALIZE_FLAGS
594 hb_buffer_serialize_glyphs()
595 hb_buffer_deserialize_glyphs()
596 hb_buffer_serialize_list_formats()
598 hb_set_add_range()
599 hb_set_del_range()
600 hb_set_get_population()
601 hb_set_next_range()
603 hb_face_[sg]et_glyph_count()
605 hb_segment_properties_t
606 HB_SEGMENT_PROPERTIES_DEFAULT
607 hb_segment_properties_equal()
608 hb_segment_properties_hash()
610 hb_buffer_set_segment_properties()
611 hb_buffer_get_segment_properties()
613 hb_ot_layout_glyph_class_t
614 hb_ot_layout_get_glyph_class()
615 hb_ot_layout_get_glyphs_in_class()
617 hb_shape_plan_t
618 hb_shape_plan_create()
619 hb_shape_plan_create_cached()
620 hb_shape_plan_get_empty()
621 hb_shape_plan_reference()
622 hb_shape_plan_destroy()
623 hb_shape_plan_set_user_data()
624 hb_shape_plan_get_user_data()
625 hb_shape_plan_execute()
626 hb_shape_plan_get_shaper()
628 hb_ot_shape_plan_collect_lookups()
631 API changes:
633 - Remove "mask" parameter from hb_buffer_add().
634 - Rename hb_ot_layout_would_substitute_lookup() and hb_ot_layout_substitute_closure_lookup().
635 - hb-set.h API const correction.
636 - Renamed hb_set_min/max() to hb_set_get_min/max().
637 - Rename hb_ot_layout_feature_get_lookup_indexes() to hb_ot_layout_feature_get_lookups().
638 - Rename hb_buffer_guess_properties() to hb_buffer_guess_segment_properties().
642 Overview of changes leading to 0.9.6
643 Sunday, November 13, 2012
644 ====================================
646 - Don't clear pre-context text if no new context is provided.
647 - Fix ReverseChainingSubstLookup, which was totally borked.
648 - Adjust output format of hb-shape a bit.
649 - Include config.h.in in-tree.  Makes it easier for alternate build systems.
650 - Fix hb_buffer_set_length(buffer, 0) invalid memory allocation.
651 - Use ICU LayoutEngine's C API instead of C++.  Avoids much headache.
652 - Drop glyphs for all of Unicode Default_Ignorable characters.
653 - Misc build fixes.
655 Arabic shaper:
656 - Enable 'dlig' and 'mset' features in Arabic shaper.
657 - Implement 'Phags-pa shaping, improve Mongolian.
659 Indic shaper:
660 - Decompose Sinhala split matras the way old HarfBuzz / Pango did.
661 - Initial support for Consonant Medials.
662 - Start adding new-style Myanmar shaping.
663 - Make reph and 'pref' logic introspect the font.
664 - Route Meetei-Mayek through the Indic shaper.
665 - Don't apply 'liga' in Indic shaper.
666 - Improve Malayalam pre-base reordering Ra interaction with Chillus.
670 Overview of changes leading to 0.9.5
671 Sunday, October 14, 2012
672 ====================================
674 - Synthetic-GSUB Arabic fallback shaping.
676 - Misc Indic improvements.
678 - Add build system support for pthread.
680 - Imported UCDN for in-tree Unicode callbacks implementation.
682 - Context-aware Arabic joining.
684 - Misc other fixes.
686 - New API:
688   hb_feature_to/from-string()
689   hb_buffer_[sg]et_content_type()
693 Overview of changes leading to 0.9.4
694 Tuesday, Sep 03, 2012
695 ====================================
697 - Indic improvements with old-spec Malayalam.
699 - Better fallback glyph positioning, specially with Thai / Lao marks.
701 - Implement dotted-circle insertion.
703 - Better Arabic fallback shaping / ligation.
705 - Added ICU LayoutEngine backend for testing.  Call it by the 'icu_le' name.
707 - Misc fixes.
711 Overview of changes leading to 0.9.3
712 Friday, Aug 18, 2012
713 ====================================
715 - Fixed fallback mark positioning for left-to-right text.
717 - Improve mark positioning for the remaining combining classes.
719 - Unbreak Thai and fallback Arabic shaping.
721 - Port Arabic shaper to shape-plan caching.
723 - Use new ICU normalizer functions.
727 Overview of changes leading to 0.9.2
728 Friday, Aug 10, 2012
729 ====================================
731 - Over a thousand commits!  This is the first major release of HarfBuzz.
733 - HarfBuzz is feature-complete now!  It should be in par, or better, than
734   both Pango's shapers and old HarfBuzz / Qt shapers.
736 - New Indic shaper, supporting main Indic scripts, Sinhala, and Khmer.
738 - Improved Arabic shaper, with fallback Arabic shaping, supporting Arabic,
739   Sinhala, N'ko, Mongolian, and Mandaic.
741 - New Thai / Lao shaper.
743 - Tibetan / Hangul support in the generic shaper.
745 - Synthetic GDEF support for fonts without a GDEF table.
747 - Fallback mark positioning for fonts without a GPOS table.
749 - Unicode normalization shaping heuristic during glyph mapping.
751 - New experimental Graphite2 backend.
753 - New Uniscribe backend (primarily for testing).
755 - New CoreText backend (primarily for testing).
757 - Major optimization and speedup.
759 - Test suites and testing infrastructure (work in progress).
761 - Greatly improved hb-view cmdline tool.
763 - hb-shape cmdline tool.
765 - Unicode 6.1 support.
767 Summary of API changes:
769 o Changed API:
771   - Users are expected to only include main header files now (ie. hb.h,
772     hb-glib.h, hb-ft.h, ...)
774   - All struct tag names had their initial underscore removed.
775     Ie. "struct _hb_buffer_t" is "struct hb_buffer_t" now.
777   - All set_user_data() functions now take a "replace" boolean parameter.
779   - hb_buffer_create() takes zero arguments now.
780     Use hb_buffer_pre_allocate() to pre-allocate.
782   - hb_buffer_add_utf*() now accept -1 for length parameteres,
783     meaning "nul-terminated".
785   - hb_direction_t enum values changed.
787   - All *_from_string() APIs now take a length parameter to allow for
788     non-nul-terminated strings. A -1 length means "nul-terminated".
790   - Typedef for hb_language_t changed.
792   - hb_get_table_func_t renamed to hb_reference_table_func_t.
794   - hb_ot_layout_table_choose_script()
796   - Various renames in hb-unicode.h.
798 o New API:
800   - hb_buffer_guess_properties()
801     Automatically called by hb_shape().
803   - hb_buffer_normalize_glyphs()
805   - hb_tag_from_string()
807   - hb-coretext.h
809   - hb-uniscribe.h
811   - hb_face_reference_blob()
812   - hb_face_[sg]et_index()
813   - hb_face_set_upem()
815   - hb_font_get_glyph_name_func_t
816     hb_font_get_glyph_from_name_func_t
817     hb_font_funcs_set_glyph_name_func()
818     hb_font_funcs_set_glyph_from_name_func()
819     hb_font_get_glyph_name()
820     hb_font_get_glyph_from_name()
821     hb_font_glyph_to_string()
822     hb_font_glyph_from_string()
824   - hb_font_set_funcs_data()
826   - hb_ft_font_set_funcs()
827   - hb_ft_font_get_face()
829   - hb-gobject.h (work in progress)
831   - hb_ot_shape_glyphs_closure()
832     hb_ot_layout_substitute_closure_lookup()
834   - hb-set.h
836   - hb_shape_full()
838   - hb_unicode_combining_class_t
840   - hb_unicode_compose_func_t
841     hb_unicode_decompose_func_t
842     hb_unicode_decompose_compatibility_func_t
843     hb_unicode_funcs_set_compose_func()
844     hb_unicode_funcs_set_decompose_func()
845     hb_unicode_funcs_set_decompose_compatibility_func()
846     hb_unicode_compose()
847     hb_unicode_decompose()
848     hb_unicode_decompose_compatibility()
850 o Removed API:
852   - hb_ft_get_font_funcs()
854   - hb_ot_layout_substitute_start()
855     hb_ot_layout_substitute_lookup()
856     hb_ot_layout_substitute_finish()
857     hb_ot_layout_position_start()
858     hb_ot_layout_position_lookup()
859     hb_ot_layout_position_finish()
863 Overview of changes leading to 0.6.0
864 Friday, May 27, 2011
865 ====================================
867 - Vertical text support in GPOS
868 - Almost all API entries have unit tests now, under test/
869 - All thread-safety issues are fixed
871 Summary of API changes follows.
874 * Simple Types API:
876   o New API:
877     HB_LANGUAGE_INVALID
878     hb_language_get_default()
879     hb_direction_to_string()
880     hb_direction_from_string()
881     hb_script_get_horizontal_direction()
882     HB_UNTAG()
884   o Renamed API:
885     hb_category_t renamed to hb_unicode_general_category_t
887   o Changed API:
888     hb_language_t is a typed pointers now
890   o Removed API:
891     HB_TAG_STR()
894 * Use ISO 15924 tags for hb_script_t:
896   o New API:
897     hb_script_from_iso15924_tag()
898     hb_script_to_iso15924_tag()
899     hb_script_from_string()
901   o Changed API:
902     HB_SCRIPT_* enum members changed value.
905 * Buffer API streamlined:
907   o New API:
908     hb_buffer_reset()
909     hb_buffer_set_length()
910     hb_buffer_allocation_successful()
912   o Renamed API:
913     hb_buffer_ensure() renamed to hb_buffer_pre_allocate()
914     hb_buffer_add_glyph() renamed to hb_buffer_add()
916   o Removed API:
917     hb_buffer_clear()
918     hb_buffer_clear_positions()
920   o Changed API:
921     hb_buffer_get_glyph_infos() takes an out length parameter now
922     hb_buffer_get_glyph_positions() takes an out length parameter now
925 * Blob API streamlined:
927   o New API:
928     hb_blob_get_data()
929     hb_blob_get_data_writable()
931   o Renamed API:
932     hb_blob_create_empty() renamed to hb_blob_get_empty()
934   o Removed API:
935     hb_blob_lock()
936     hb_blob_unlock()
937     hb_blob_is_writable()
938     hb_blob_try_writable()
940   o Changed API:
941     hb_blob_create() takes user_data before destroy now
944 * Unicode functions API:
946   o Unicode function vectors can subclass other unicode function vectors now.
947     Unimplemented callbacks in the subclass automatically chainup to the parent.
949   o All hb_unicode_funcs_t callbacks take a user_data now.  Their setters
950     take a user_data and its respective destroy callback.
952   o New API:
953     hb_unicode_funcs_get_empty()
954     hb_unicode_funcs_get_default()
955     hb_unicode_funcs_get_parent()
957   o Changed API:
958     hb_unicode_funcs_create() now takes a parent_funcs.
960   o Removed func getter functions:
961     hb_unicode_funcs_get_mirroring_func()
962     hb_unicode_funcs_get_general_category_func()
963     hb_unicode_funcs_get_script_func()
964     hb_unicode_funcs_get_combining_class_func()
965     hb_unicode_funcs_get_eastasian_width_func()
968 * Face API:
970   o Renamed API:
971     hb_face_get_table() renamed to hb_face_reference_table()
972     hb_face_create_for_data() renamed to hb_face_create()
974   o Changed API:
975     hb_face_create_for_tables() takes user_data before destroy now
976     hb_face_reference_table() returns empty blob instead of NULL
977     hb_get_table_func_t accepts the face as first parameter now
979 * Font API:
981   o Fonts can subclass other fonts now.  Unimplemented callbacks in the
982     subclass automatically chainup to the parent.  When chaining up,
983     scale is adjusted if the parent font has a different scale.
985   o All hb_font_funcs_t callbacks take a user_data now.  Their setters
986     take a user_data and its respective destroy callback.
988   o New API:
989     hb_font_get_parent()
990     hb_font_funcs_get_empty()
991     hb_font_create_sub_font()
993   o Removed API:
994     hb_font_funcs_copy()
995     hb_font_unset_funcs()
997   o Removed func getter functions:
998     hb_font_funcs_get_glyph_func()
999     hb_font_funcs_get_glyph_advance_func()
1000     hb_font_funcs_get_glyph_extents_func()
1001     hb_font_funcs_get_contour_point_func()
1002     hb_font_funcs_get_kerning_func()
1004   o Changed API:
1005     hb_font_create() takes a face and references it now
1006     hb_font_set_funcs() takes user_data before destroy now
1007     hb_font_set_scale() accepts signed integers now
1008     hb_font_get_contour_point_func_t now takes glyph first, then point_index
1009     hb_font_get_glyph_func_t returns a success boolean now
1012 * Changed object model:
1014   o All object types have a _get_empty() now:
1015     hb_blob_get_empty()
1016     hb_buffer_get_empty()
1017     hb_face_get_empty()
1018     hb_font_get_empty()
1019     hb_font_funcs_get_empty()
1020     hb_unicode_funcs_get_empty()
1022   o Added _set_user_data() and _get_user_data() for all object types:
1023     hb_blob_get_user_data()
1024     hb_blob_set_user_data()
1025     hb_buffer_get_user_data()
1026     hb_buffer_set_user_data()
1027     hb_face_get_user_data()
1028     hb_face_set_user_data()
1029     hb_font_funcs_get_user_data()
1030     hb_font_funcs_set_user_data()
1031     hb_font_get_user_data()
1032     hb_font_set_user_data()
1033     hb_unicode_funcs_get_user_data()
1034     hb_unicode_funcs_set_user_data()
1036   o Removed the _get_reference_count() from all object types:
1037     hb_blob_get_reference_count()
1038     hb_buffer_get_reference_count()
1039     hb_face_get_reference_count()
1040     hb_font_funcs_get_reference_count()
1041     hb_font_get_reference_count()
1042     hb_unicode_funcs_get_reference_count()
1044   o Added _make_immutable() and _is_immutable() for all object types except for buffer:
1045     hb_blob_make_immutable()
1046     hb_blob_is_immutable()
1047     hb_face_make_immutable()
1048     hb_face_is_immutable()
1051 * Changed API for vertical text support
1053   o The following callbacks where removed:
1054     hb_font_get_glyph_advance_func_t
1055     hb_font_get_kerning_func_t
1057   o The following new callbacks added instead:
1058     hb_font_get_glyph_h_advance_func_t
1059     hb_font_get_glyph_v_advance_func_t
1060     hb_font_get_glyph_h_origin_func_t
1061     hb_font_get_glyph_v_origin_func_t
1062     hb_font_get_glyph_h_kerning_func_t
1063     hb_font_get_glyph_v_kerning_func_t
1065   o The following API removed as such:
1066     hb_font_funcs_set_glyph_advance_func()
1067     hb_font_funcs_set_kerning_func()
1068     hb_font_get_glyph_advance()
1069     hb_font_get_kerning()
1071   o New API added instead:
1072     hb_font_funcs_set_glyph_h_advance_func()
1073     hb_font_funcs_set_glyph_v_advance_func()
1074     hb_font_funcs_set_glyph_h_origin_func()
1075     hb_font_funcs_set_glyph_v_origin_func()
1076     hb_font_funcs_set_glyph_h_kerning_func()
1077     hb_font_funcs_set_glyph_v_kerning_func()
1078     hb_font_get_glyph_h_advance()
1079     hb_font_get_glyph_v_advance()
1080     hb_font_get_glyph_h_origin()
1081     hb_font_get_glyph_v_origin()
1082     hb_font_get_glyph_h_kerning()
1083     hb_font_get_glyph_v_kerning()
1085   o The following higher-leve API added for convenience:
1086     hb_font_get_glyph_advance_for_direction()
1087     hb_font_get_glyph_origin_for_direction()
1088     hb_font_add_glyph_origin_for_direction()
1089     hb_font_subtract_glyph_origin_for_direction()
1090     hb_font_get_glyph_kerning_for_direction()
1091     hb_font_get_glyph_extents_for_origin()
1092     hb_font_get_glyph_contour_point_for_origin()
1095 * OpenType Layout API:
1097   o New API:
1098     hb_ot_layout_position_start()
1099     hb_ot_layout_substitute_start()
1100     hb_ot_layout_substitute_finish()
1103 * Glue code:
1105   o New API:
1106     hb_glib_script_to_script()
1107     hb_glib_script_from_script()
1108     hb_icu_script_to_script()
1109     hb_icu_script_from_script()
1112 * Version API added:
1114   o New API:
1115     HB_VERSION_MAJOR
1116     HB_VERSION_MINOR
1117     HB_VERSION_MICRO
1118     HB_VERSION_STRING
1119     HB_VERSION_CHECK()
1120     hb_version()
1121     hb_version_string()
1122     hb_version_check()