NEWS

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