src/third_party/harfbuzz-ng/NEWS

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