NEWS

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