NEWS

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