Bug 1891710: part 2) Enable <Element-outerHTML.html> WPT for Trusted Types. r=smaug
[gecko.git] / gfx / harfbuzz / NEWS
blobe94c6a89379d6ea1e2dd0ab762c14a89dc68b4b5
1 Overview of changes leading to 8.4.0
2 Saturday, March 29, 2024
3 ====================================
4 - Add /bigobj to MSVC compiler flags in meson build, to fix building hb-subset.cc
5 - Specify minimum versions of various dependencies in meson and autotools build.
6 - When subsetting, place variation store at the end of “GDEF” table  to fix
7   shaping issues with some versions of Adobe InDesign.
8 - Various build fixes.
10 - New API:
11 +hb_buffer_set_random_state()
12 +hb_buffer_get_random_state()
14 Overview of changes leading to 8.3.1
15 Saturday, March 16, 2024
16 ====================================
17 - hb_blob_create_from_file_or_fail() on Windows will now try to interpret the
18   file name as UTF-8 first, and as system code page if it is not valid UTF-8.
19 - Fix hb_style_get_value() in fonts with “STAT” table.
20 - Properly handle negative offsets in CFF table.
21 - Update IANA Language Subtag Registry to 2024-03-07.
22 - Subsetter now supports subsetting “BASE” table.
23 - Subsetter will update “hhea” font metrics in sync with “OS/2” ones.
24 - “--variations” option of “hb-subset” now supports leaving out values that
25   should be unchanged, e.g. “wght=:500:” will change the default and keep max
26   and min unchanged. It also supports “*=drop” to to pin all axes to default
27   location.
28 - Fix hb_ot_math_get_glyph_kerning() to match updated “MATH” table spec.
29 - Support legacy MacRoman encoding in “cmap” table.
30 - Various build fixes.
31 - Various subsetting and instancing fixes.
33 - New API:
34 hb_subset_input_pin_all_axes_to_default()
36 Overview of changes leading to 8.3.0
37 Saturday, November 11, 2023
38 ====================================
39 - Improve memory barrier to fix potential segfaults.
40 - Various build fixes.
41 - Various subsetting and instancing fixes.
42 - Rename “hb-subset” option “--instance” to “--variations” to match the other
43   tools. Old option is kept as an alias.
45 - New API:
46 HB_AAT_LAYOUT_FEATURE_TYPE_CURSIVE_CONNECTION
48 - Deprecated API:
49 HB_AAT_LAYOUT_FEATURE_TYPE_CURISVE_CONNECTION
51 Overview of changes leading to 8.2.2
52 Wednesday, October 18, 2023
53 “From the river to the sea, Palestine will be free”
54 ====================================
55 - Fix regression from 8.1.0 in shaping fonts with duplicate feature tags.
56 - Fix regression from 8.2.0 in parsing CSS-style feature strings.
57 - Variable fonts instanciation now handles more tables.
58 - Various CMake build improvements.
59 - various fixes to build without errors with gcc 4.9.2.
62 Overview of changes leading to 8.2.1
63 Monday, September 18, 2023
64 ====================================
65 - Unicode 15.1 support.
68 Overview of changes leading to 8.2.0
69 Friday, September 8, 2023
70 ====================================
71 - Various build and fuzzing fixes
72 - Improvements to COLRv1 painting.
74 - New API:
75 +hb_paint_color_glyph_func_t
76 +hb_paint_funcs_set_color_glyph_func
77 +hb_paint_color_glyph
80 Overview of changes leading to 8.1.1
81 Wednesday, August 2, 2023
82 ====================================
83 - Fix shaping of contextual rules at the end of string, introduced in 8.1.0
84 - Fix stack-overflow in repacker with malicious fonts.
85 - 30% speed up loading Noto Duployan font.
88 Overview of changes leading to 8.1.0
89 Tuesday, August 1, 2023
90 ====================================
91 - Fix long-standing build issue with the AIX compiler and older Apple clang.
93 - Revert optimization that could cause timeout during subsetting with malicious fonts.
95 - More optimization work:
96   - 45% speed up in shaping Noto Duployan font.
97   - 10% speed up in subsetting Noto Duployan font.
98   - Another 8% speed up in shaping Gulzar.
99   - 5% speed up in loading Roboto.
101 - New API:
102 +hb_ot_layout_collect_features_map()
105 Overview of changes leading to 8.0.1
106 Wednesday, July 12, 2023
107 ====================================
108 - Build fix on 32-bit ARM.
110 - More speed optimizations:
111   - 60% speed up in retain-gid (used for IFT) subsetting of SourceHanSans-VF.
112   - 16% speed up in retain-gid (used for IFT) subsetting of NotoSansCJKkr.
113   - 38% speed up in subsetting (beyond-64k) mega-merged Noto.
116 Overview of changes leading to 8.0.0
117 Sunday, July 9, 2023
118 ====================================
119 - New, experimental, WebAssembly (WASM) shaper, that provides greater
120   flexibility over OpenType/AAT/Graphite shaping, using WebAssembly embedded
121   inside the font file. Currently WASM shaper is disabled by default and needs
122   to be enabled at build time. For details, see:
124     https://github.com/harfbuzz/harfbuzz/blob/main/docs/wasm-shaper.md
126   For example fonts making use of the WASM shaper, see:
128     https://github.com/harfbuzz/harfbuzz-wasm-examples
130 - Improvements to Experimental features introduced in earlier releases:
131   - Support for subsetting beyond-64k and VarComposites fonts.
132   - Support for instancing variable fonts with cubic “glyf” table.
134 - Many big speed optimizations:
135   - Up to 89% speedup loading variable fonts for shaping.
136   - Up to 88% speedup in small subsets of large (eg. CJK) fonts (both TTF and
137     OTF), essential for Incremental Font Transfer (IFT).
138   - Over 50% speedup in loading Roboto font for shaping.
139   - Up to 40% speed up in loading (sanitizing) complex fonts.
140   - 30% speed up in shaping Gulzar font.
141   - Over 25% speedup in glyph loading Roboto font.
142   - 10% speed up loading glyph shapes in VarComposite Hangul font.
143   - hb-hashmap optimizations & hashing improvements.
145 - New macro HB_ALWAYS_INLINE. HarfBuzz now inlines functions more aggressively,
146   which results in some speedup at the expense of bigger code size. To disable
147   this feature define the macro to just inline.
149 - New API:
150 +HB_CODEPOINT_INVALID
151 +hb_ot_layout_get_baseline2()
152 +hb_ot_layout_get_baseline_with_fallback2()
153 +hb_ot_layout_get_font_extents()
154 +hb_ot_layout_get_font_extents2()
155 +hb_subset_input_set_axis_range()
158 Overview of changes leading to 7.3.0
159 Tuesday, May 9, 2023
160 ====================================
161 - Speedup applying glyph variation in VarComposites fonts (over 40% speedup).
162   (Behdad Esfahbod)
163 - Speedup instancing some fonts (over 20% speedup in instancing RobotoFlex).
164   (Behdad Esfahbod)
165 - Speedup shaping some fonts (over 30% speedup in shaping Roboto).
166   (Behdad Esfahbod)
167 - Support subsetting VarComposites and beyond-64k fonts. (Behdad Esfahbod)
168 - New configuration macro HB_MINIMIZE_MEMORY_USAGE to favor optimizing memory
169   usage over speed. (Behdad Esfahbod)
170 - Supporting setting the mapping between old and new glyph indices during
171   subsetting. (Garret Rieger)
172 - Various fixes and improvements.
173   (Behdad Esfahbod, Denis Rochette, Garret Rieger, Han Seung Min, Qunxin Liu)
175 - New API:
176 +hb_subset_input_old_to_new_glyph_mapping()
179 Overview of changes leading to 7.2.0
180 Thursday, April 27, 2023
181 ====================================
182 - Add Tifinagh to the list of scripts that can natively be either right-to-left
183   or left-to-right, to improve handling of its glyph positioning.
184   (Simon Cozens)
185 - Return also single substitution from hb_ot_layout_lookup_get_glyph_alternates()
186   (Behdad Esfahbod)
187 - Fix 4.2.0 regression in applying across syllables in syllabic scripts.
188   (Behdad Esfahbod)
189 - Add flag to avoid glyph substitution closure during subsetting, and the
190   corresponding “--no-layout-closure” option to “hb-subset” command line tool.
191   (Garret Rieger)
192 - Support instancing COLRv1 table. (Qunxin Liu)
193 - Don’t drop used user-defined name table entries during subsetting.
194   (Qunxin Liu)
195 - Optimize handling of “gvar” table. (Behdad Esfahbod)
196 - Various subsetter bug fixes and improvements. (Garret Rieger, Qunxin Liu)
197 - Various documentation improvements. (Behdad Esfahbod, Josef Friedrich)
199 - New API:
200 +HB_SUBSET_FLAGS_NO_LAYOUT_CLOSURE
201 +HB_UNICODE_COMBINING_CLASS_CCC132
203 - Deprecated API:
204 +HB_UNICODE_COMBINING_CLASS_CCC133
207 Overview of changes leading to 7.1.0
208 Friday, March 3, 2023
209 ====================================
210 - New experimental hb_shape_justify() API that uses font variations to expand
211   or shrink the text to a given advance. (Behdad Esfahbod)
212 - Various build and bug fixes. (Behdad Esfahbod, Garret Rieger, Qunxin Liu)
214 - New API:
215 +hb_font_set_variation()
218 Overview of changes leading to 7.0.1
219 Monday, February 20, 2023
220 ====================================
221 - Various build and bug fixes.
224 Overview of changes leading to 7.0.0
225 Saturday, February 11, 2023
226 ====================================
227 - New hb-paint API that is designed mainly to paint “COLRv1” glyphs, but can be
228   also used as a unified API to paint any of the glyph representations
229   supported by HarfBuzz (B/W outlines, color layers, or color bitmaps).
230   (Behdad Esfahbod, Matthias Clasen)
231 - New hb-cairo API for integrating with cairo graphics library. This is provided
232   as a separate harfbuzz-cairo library. (Behdad Esfahbod, Matthias Clasen)
233 - Support for instancing “CFF2” table. (Behdad Esfahbod)
234 - Support font emboldening. (Behdad Esfahbod)
235 - Support feature ranges with AAT shaping. (Behdad Esfahbod)
236 - Experimental support to cubic curves in “glyf” table, see
237   https://github.com/harfbuzz/boring-expansion-spec/blob/main/glyf1-cubicOutlines.md
238   for spec. (Behdad Esfahbod)
239 - Various subsetter improvements. (Garret Rieger, Qunxin Liu, Behdad Esfahbod)
240 - Various documentation improvements.
241   (Behdad Esfahbod, Matthias Clasen, Khaled Hosny)
242 - Significantly reduced memory use during shaping. (Behdad Esfahbod)
243 - Greatly reduced memory use during subsetting “CFF” table. (Behdad Esfahbod)
244 - New command line utility, hb-info, for querying various font information.
245   (Behdad Esfahbod, Matthias Clasen)
246 - New hb-shape/hb-view options: --glyphs, --color-palette, --font-bold,
247   --font-grade, and --named-instance. (Behdad Esfahbod)
248 - Miscellaneous fixes and improvements.
249   (Amir Masoud Abdol, Andres Salomon, Behdad Esfahbod, Chun-wei Fan,
250   Garret Rieger, Jens Kutilek, Khaled Hosny, Konstantin Käfer, Matthias Clasen,
251   Nirbheek Chauhan, Pedro J. Estébanez, Qunxin Liu, Sergei Trofimovich)
253 - New API:
254 +HB_FONT_NO_VAR_NAMED_INSTANCE
255 +HB_PAINT_IMAGE_FORMAT_BGRA
256 +HB_PAINT_IMAGE_FORMAT_PNG
257 +HB_PAINT_IMAGE_FORMAT_SVG
258 +hb_cairo_font_face_create_for_face
259 +hb_cairo_font_face_create_for_font
260 +hb_cairo_font_face_get_face
261 +hb_cairo_font_face_get_font
262 +hb_cairo_font_face_get_scale_factor
263 +hb_cairo_font_face_set_font_init_func
264 +hb_cairo_font_face_set_scale_factor
265 +hb_cairo_font_init_func_t
266 +hb_cairo_glyphs_from_buffer
267 +hb_cairo_scaled_font_get_font
268 +hb_color_line_get_color_stops
269 +hb_color_line_get_color_stops_func_t
270 +hb_color_line_get_extend
271 +hb_color_line_get_extend_func_t
272 +hb_color_line_t
273 +hb_color_stop_t
274 +hb_draw_funcs_get_empty
275 +hb_draw_funcs_get_user_data
276 +hb_draw_funcs_set_user_data
277 +hb_face_collect_nominal_glyph_mapping
278 +hb_font_draw_glyph
279 +hb_font_draw_glyph_func_t
280 +hb_font_funcs_set_draw_glyph_func
281 +hb_font_funcs_set_paint_glyph_func
282 +hb_font_get_synthetic_bold
283 +hb_font_get_var_named_instance
284 +hb_font_paint_glyph
285 +hb_font_paint_glyph_func_t
286 +hb_font_set_synthetic_bold
287 +hb_map_keys
288 +hb_map_next
289 +hb_map_update
290 +hb_map_values
291 +hb_ot_color_glyph_has_paint
292 +hb_ot_color_has_paint
293 +hb_ot_layout_script_select_language2
294 +hb_ot_name_id_predefined_t
295 +hb_paint_color
296 +hb_paint_color_func_t
297 +hb_paint_composite_mode_t
298 +hb_paint_custom_palette_color
299 +hb_paint_custom_palette_color_func_t
300 +hb_paint_extend_t
301 +hb_paint_funcs_create
302 +hb_paint_funcs_destroy
303 +hb_paint_funcs_get_empty
304 +hb_paint_funcs_get_user_data
305 +hb_paint_funcs_is_immutable
306 +hb_paint_funcs_make_immutable
307 +hb_paint_funcs_reference
308 +hb_paint_funcs_set_color_func
309 +hb_paint_funcs_set_custom_palette_color_func
310 +hb_paint_funcs_set_image_func
311 +hb_paint_funcs_set_linear_gradient_func
312 +hb_paint_funcs_set_pop_clip_func
313 +hb_paint_funcs_set_pop_group_func
314 +hb_paint_funcs_set_pop_transform_func
315 +hb_paint_funcs_set_push_clip_glyph_func
316 +hb_paint_funcs_set_push_clip_rectangle_func
317 +hb_paint_funcs_set_push_group_func
318 +hb_paint_funcs_set_push_transform_func
319 +hb_paint_funcs_set_radial_gradient_func
320 +hb_paint_funcs_set_sweep_gradient_func
321 +hb_paint_funcs_set_user_data
322 +hb_paint_funcs_t
323 +hb_paint_image
324 +hb_paint_image_func_t
325 +hb_paint_linear_gradient
326 +hb_paint_linear_gradient_func_t
327 +hb_paint_pop_clip
328 +hb_paint_pop_clip_func_t
329 +hb_paint_pop_group
330 +hb_paint_pop_group_func_t
331 +hb_paint_pop_transform
332 +hb_paint_pop_transform_func_t
333 +hb_paint_push_clip_glyph
334 +hb_paint_push_clip_glyph_func_t
335 +hb_paint_push_clip_rectangle
336 +hb_paint_push_clip_rectangle_func_t
337 +hb_paint_push_group
338 +hb_paint_push_group_func_t
339 +hb_paint_push_transform
340 +hb_paint_push_transform_func_t
341 +hb_paint_radial_gradient
342 +hb_paint_radial_gradient_func_t
343 +hb_paint_sweep_gradient
344 +hb_paint_sweep_gradient_func_t
345 +hb_set_is_inverted
346 +hb_subset_input_keep_everything
348 - Deprecated API:
349 +hb_font_funcs_set_glyph_shape_func
350 +hb_font_get_glyph_shape_func_t
351 +hb_font_get_glyph_shape
354 Overview of changes leading to 6.0.0
355 Friday, December 16, 2022
356 ====================================
357 - A new API have been added to pre-process the face and speed up future
358   subsetting operations on that face. Provides up to a 95% reduction in
359   subsetting times when the same face is subset more than once.
361   For more details and benchmarks, see:
362   https://github.com/harfbuzz/harfbuzz/blob/main/docs/subset-preprocessing.md
364   (Garret Rieger, Behdad Esfahbod)
366 - Shaping have been speedup by skipping entire lookups when the buffer contents
367   don't intersect with the lookup. Shows up to a 10% speedup in shaping some
368   fonts. (Behdad Esfahbod)
370 - A new experimental feature, “Variable Composites” (enabled by passing
371   -Dexperimental_api=true to meson), is also featured in this release.
372   This technology enables drastic compression of fonts in the Chinese,
373   Japanese, Korean, and other writing systems, by reusing the OpenType Font
374   Variations technology for encoding “smart components” into the font.
376   The specification for these  extensions to the font format can be found in:
377   https://github.com/harfbuzz/boring-expansion-spec/blob/glyf1/glyf1.md
379   A test variable-font with ~7160 Hangul syllables derived from the
380   NotoSerifKR-VF font has been built, with existing OpenType technology, as
381   well as with the new Variable Composites (VarComposites) technology. The
382   VarComposites font is over 90% smaller than the OpenType version of the font!
383   Both fonts can be obtained from the “smarties” repository:
384   https://github.com/behdad/smarties/tree/3.0/fonts/hangul/serif
386   When building HarfBuzz with experimental features enabled, you can test
387   the “smarties” font with a sample character like this:
389   $ hb-view butchered-hangul-serif-smarties-variable.ttf -u AE01 --variations=wght=700
391   (Behdad Esfahbod)
393 - The HarfBuzz subsetter can now drop axes by pinning them to specific values
394   (also referred to as instancing). There are a couple of restrictions
395   currently:
397   - Only works with TrueType (“glyf”) based fonts. “CFF2” fonts are not yet
398     supported.
399   - Only supports the case where all axes in a font are pinned.
401   (Garret Rieger, Qunxin Liu)
403 - Miscellaneous fixes and improvements.
405   (Behdad Esfahbod, Christoph Reiter, David Corbett, Eli Schwartz, Garret
406    Rieger, Joel Auterson, Jordan Petridis, Khaled Hosny, Lorenz Wildberg,
407    Marco Rebhan, Martin Storsjö, Matthias Clasen, Qunxin Liu, Satadru Pramanik)
410 - New API
411 +hb_subset_input_pin_axis_location()
412 +hb_subset_input_pin_axis_to_default()
413 +hb_subset_preprocess()
416 Overview of changes leading to 5.3.1
417 Wednesday, October 19, 2022
418 ====================================
419 - Subsetter repacker fixes. (Garret Rieger)
420 - Adjust Grapheme clusters for Katakana voiced sound marks. (Behdad Esfahbod)
421 - New “hb-subset” option “--preprocess-face”. (Garret Rieger)
424 Overview of changes leading to 5.3.0
425 Saturday, October 8, 2022
426 "Women, Life, Freedom" #MahsaAmini
427 ====================================
428 - Don’t add glyphs from dropped MATH or COLR tables to the subset glyphs.
429   (Khaled Hosny)
430 - Map “rlig” to appropriate AAT feature selectors. (Jonathan Kew)
431 - Update USE data files to latest version. (David Corbett)
432 - Check “CBDT” extents first before outline tables, to help with fonts that
433   also include an empty “glyf” table. (Khaled Hosny)
434 - More work towards variable font instancing in the subsetter. (Qunxin Liu)
435 - Subsetter repacker improvements. (Garret Rieger)
436 - New API:
437 +hb_ot_layout_lookup_get_optical_bound()
438 +hb_face_builder_sort_tables()
441 Overview of changes leading to 5.2.0
442 Saturday, September 17, 2022
443 ====================================
444 - Fix regressions in hb-ft font functions for FT_Face’s with transformation
445   matrix. (Behdad Esfahbod)
446 - The experimental hb-repacker API now supports splitting several GPOS subtable
447   types when needed. (Garret Rieger)
448 - The HarfBuzz extensions to OpenType font format are now opt-in behind
449   build-time flags. (Behdad Esfahbod)
450 - The experimental hb-subset variable fonts instantiation API can now
451   instantiate more font tables and arbitrary axis locations. (Qunxin Liu)
452 - Unicode 15 support. (David Corbett)
453 - Various documentation improvements. (Behdad Esfahbod, Matthias Clasen)
454 - The hb-view command line tool now detects WezTerm inline images support.
455   (Wez Furlong)
456 - Fix FreeType and ICU dependency lookup with meson. (Xavier Claessens)
458 - New API:
459 +HB_SCRIPT_KAWI
460 +HB_SCRIPT_NAG_MUNDARI
463 Overview of changes leading to 5.1.0
464 Sunday, July 31, 2022
465 ====================================
466 - More extensive buffer tracing messages. (Behdad Esfahbod)
467 - Fix hb-ft regression in bitmap fonts rendering. (Behdad Esfahbod)
468 - Support extension promotion of lookups in hb-subset-repacker. (Garret Rieger)
469 - A new HB_GLYPH_FLAG_SAFE_TO_INSERT_TATWEEL for scripts that use elongation
470   (e.g. Arabic) to signify where it is safe to insert tatweel glyph without
471   interrupting shaping. (Behdad Esfahbod)
472 - Add “--safe-to-insert-tatweel” to “hb-shape” tool. (Behdad Esfahbod)
474 - New API
475 +HB_GLYPH_FLAG_SAFE_TO_INSERT_TATWEEL
476 +HB_BUFFER_FLAG_PRODUCE_SAFE_TO_INSERT_TATWEEL
479 Overview of changes leading to 5.0.1
480 Saturday, July 23, 2022
481 ====================================
482 - Fix version 2 “avar” table with hb-ft. (Behdad Esfahbod)
485 Overview of changes leading to 5.0.0
486 Saturday, July 23, 2022
487 ====================================
488 - Support fonts with more than 65535 glyphs in “GDEF”, “GSUB”, and “GPOS”
489   tables. This is part of https://github.com/be-fonts/boring-expansion-spec to
490   extend OpenType in a backward-compatible way.
491   (Behdad Esfahbod, Garret Rieger)
492 - Complete support for more than 65535 glyphs in “glyf” table that started in
493   4.0.0 release. Part of boring-expansion-spec. (Behdad Esfahbod)
494 - Support version 2 of “avar” table. Part of boring-expansion-spec.
495   (Behdad Esfahbod)
496 - Fix mark attachment on multiple substitutions in some cases.
497   (Behdad Esfahbod)
498 - Fix application of “calt”, “rclt”, and “ccmp” features to better match
499   Uniscribe behaviour with some Arabic fonts. (Behdad Esfahbod)
500 - Improvement to interaction between multiple cursive attachments.
501   (Behdad Esfahbod)
502 - Improve multiple mark interactions in Hebrew. (Behdad Esfahbod)
503 - Implement language-specific forms in AAT shaping. (Behdad Esfahbod)
504 - Fix variation of “VORG” table. (Behdad Esfahbod)
505 - Support for specific script tags to be retained in the subsetter, and add
506   “--layout-scripts” option to “hb-subset” tool. (Garret Rieger)
507 - Accept space as delimiter for --features/--variations in command line tools.
508 - Improve subsetting of “COLR” table. (Qunxin Liu)
509 - Improved fuzzing coverage for ot-math API. (Frédéric Wang)
510 - Fix “kern” table version 2 (AAT) sanitization on 32-bit systems.
511   (Behdad Esfahbod)
512 - Allow negative glyph advances from “graphite2” shaper. (Stephan Bergmann)
513 - Implement loading (color) bitmap fonts with hb-ft. (Behdad Esfahbod)
514 - Fix regression in hb-ft when changing font size. (Behdad Esfahbod)
515 - Fix build on GCC < 7. (Kleis Auke Wolthuizen)
516 - Dynamically load dwrite.dll on windows if “directwrite” shaper is enabled.
517   (Luca Bacci)
518 - Provide a single-file harfbuzz-subset.cc file for easier alternate building
519   of hb-subset library, similar to harfbuzz.cc. (Khaled Hosny)
521 - New API
522 +HB_SUBSET_SETS_LAYOUT_SCRIPT_TAG
523 +hb_language_matches()
526 Overview of changes leading to 4.4.1
527 Wednesday, June 29, 2022
528 ====================================
529 - Fix test failure with some compilers.
530 - Fix Telugu and Kannada kerning regression.
533 Overview of changes leading to 4.4.0
534 Monday, June 27, 2022
535 ====================================
536 - Caching of variable fonts shaping, in particular when using HarfBuzz’s own
537   font loading functions (ot). Bringing performance of variable shaping in par
538   with non-variable fonts shaping. (Behdad Esfahbod)
539 - Caching of format 2 “Contextual Substitution” and “Chained Contexts
540   Substitution” lookups. Resulting in up to 20% speedup of lookup-heavy fonts
541   like Gulzar or Noto Nastaliq Urdu. (Behdad Esfahbod)
542 - Improved ANSI output from hb-view. (Behdad Esfahbod)
543 - Support for shaping legacy, pre-OpenType Windows 3.1-era, Arabic fonts that
544   relied on a fixed PUA encoding. (Khaled Hosny, Behdad Esfahbod)
545 - Sinhala script is now shaped by the USE shaper instead of “indic” one.
546   (Behdad Esfahbod, David Corbett)
547 - Thai shaper improvements. (David Corbett)
548 - hb-ot-name API supports approximate BCP-47 language matching, for example
549   asking for “en_US” in a font that has only “en” names will return them.
550   (Behdad Esfahbod)
551 - Optimized TrueType glyph shape loading. (Behdad Esfahbod)
552 - Fix subsetting of HarfBuzz faces created via hb_face_create_for_tables().
553   (Garret Rieger)
554 - Add 32 bit var store support to the subsetter. (Garret Rieger)
556 - New API
557 +HB_BUFFER_FLAG_DEFINED
558 +HB_BUFFER_SERIALIZE_FLAG_DEFINED
559 +hb_font_changed()
560 +hb_font_get_serial()
561 +hb_ft_hb_font_changed()
562 +hb_set_hash()
563 +hb_map_copy()
564 +hb_map_hash()
567 Overview of changes leading to 4.3.0
568 Friday, May 20, 2022
569 ====================================
570 - Major speed up in loading and subsetting fonts, especially in
571   handling CFF table. Subsetting some fonts is now 3 times faster.
572   (Behdad Esfahbod, Garret Rieger)
573 - Speed up blending CFF2 table. (Behdad Esfahbod)
574 - Speed up hb_ot_tags_from_language(). (Behdad Esfahbod, David Corbett)
575 - Fix USE classification of U+10A38 to fix multiple marks on single Kharoshthi
576   base. (David Corbett)
577 - Fix parsing of empty CFF Index. (Behdad Esfahbod)
578 - Fix subsetting CPAL table with partial palette overlaps. (Garret Rieger)
580 - New API
581 +hb_map_is_equal() (Behdad Esfahbod)
584 Overview of changes leading to 4.2.1
585 Sunday, April 24, 2022
586 ====================================
587 - Make sure hb_blob_create_from_file_or_fail() always returns nullptr in case
588   of failure and not empty blob sometimes. (Khaled Hosny)
589 - Add --passthrough-tables option to hb-subset. (Cosimo Lupo)
590 - Reinstate a pause after basic features in Khmer shaper, fixing a regression
591   introduced in previous release. (Behdad Esfahbod)
592 - Better handling of Regional_Indicator when shaped with RTL-native scripts,
593   reverting earlier fix that caused regressions in AAT shaping. (Behdad Esfahbod)
596 Overview of changes leading to 4.2.0
597 Wednesday, March 30, 2022
598 ====================================
599 - Source code reorganization, splitting large hb-ot-layout files into smaller,
600   per-subtable ones under OT/Layout/*. Code for more tables will follow suit in
601   later releases. (Garret Rieger, Behdad Esfahbod)
602 - Revert Indic shaper change in previous release that broke some fonts and
603   instead make per-syllable restriction of “GSUB” application limited to
604   script-specific Indic features, while applying them and discretionary
605   features in one go. (Behdad Esfahbod)
606 - Fix decoding of private in gvar table. (Behdad Esfahbod)
607 - Fix handling of contextual lookups that delete too many glyphs. (Behdad Esfahbod)
608 - Make “morx” deleted glyphs don’t block “GPOS” application. (Behdad Esfahbod)
609 - Various build fixes. (Chun-wei Fan, Khaled Hosny)
611 - New API
612 +hb_set_next_many() (Andrew John)
615 Overview of changes leading to 4.1.0
616 Wednesday, March 23, 2022
617 ====================================
618 - Various OSS-Fuzz fixes. (Behdad Esfahbod)
619 - Make fallback vertical-origin match FreeType’s. (Behdad Esfahbod)
620 - Treat visible viramas like dependent vowels in USE shaper. (David Corbett)
621 - Apply presentation forms features and discretionary features in one go in
622   Indic shaper, which seems to match Uniscribe and CoreText behaviour.
623   (Behdad Esfahbod, David Corbett)
624 - Various bug fixes.
626 - New API
627 +hb_set_add_sorted_array() (Andrew John)
630 Overview of changes leading to 4.0.1
631 Friday, March 11, 2022
632 ====================================
633 - Update OpenType to AAT mappings for “hist” and “vrtr” features.
634   (Florian Pircher)
635 - Update IANA Language Subtag Registry to 2022-03-02. (David Corbett)
636 - Update USE shaper to allow any non-numeric tail in a symbol cluster, and
637   remove obsolete data overrides. (David Corbett)
638 - Fix handling of baseline variations to return correctly scaled values.
639   (Matthias Clasen)
640 - A new experimental hb_subset_repack_or_fail() to repack an array of objects,
641   eliminating offset overflows. The API is not available unless HarfBuzz is
642   built with experimental APIs enabled. (Qunxin Liu)
644 - New experimental API
645 +hb_link_t
646 +hb_object_t
647 +hb_subset_repack_or_fail()
650 Overview of changes leading to 4.0.0
651 Tuesday, March 1, 2022
652 ====================================
653 - New public API to create subset plan and gather information on things like
654   glyph mappings in the final subset. The plan can then be passed on to perform
655   the subsetting operation. (Garret Rieger)
656 - Draw API for extracting glyph shapes have been extended and finalized and is
657   no longer an experimental API. The draw API supports glyf, CFF and CFF2
658   glyph outlines tables, and applies variation settings set on the font as well
659   as synthetic slant. The new public API is not backward compatible with the
660   previous, non-public, experimental API. (Behdad Esfahbod)
661 - The hb-view tool will use HarfBuzz draw API to render the glyphs instead of
662   cairo-ft when compiled with Cairo 1.17.5 or newer, setting HB_DRAW
663   environment variable to 1 or 0 will force using or not use the draw API,
664   respectively. (Behdad Esfahbod)
665 - The hb-shape and hb-view tools now default to using HarfBuzz’s own font
666   loading functions (ot) instead of FreeType ones (ft). They also have a new
667   option, --font-slant, to apply synthetic slant to the font. (Behdad Esfahbod)
668 - HarfBuzz now supports more than 65535 (the OpenType limit) glyph shapes and
669   metrics. See https://github.com/be-fonts/boring-expansion-spec/issues/6 and
670   https://github.com/be-fonts/boring-expansion-spec/issues/7 for details.
671   (Behdad Esfahbod)
672 - New API to get the dominant horizontal baseline tag for a given script.
673   (Behdad Esfahbod)
674 - New API to get the baseline positions from the font, and synthesize missing
675   ones. As well as new API to get font metrics and synthesize missing ones.
676   (Matthias Clasen)
677 - Improvements to finding dependencies on Windows when building with Visual
678   Studio. (Chun-wei Fan)
679 - New buffer flag, HB_BUFFER_FLAG_PRODUCE_UNSAFE_TO_CONCAT, that must be set
680   during shaping for HB_GLYPH_FLAG_UNSAFE_TO_CONCAT flag to be reliably
681   produced. This is to limit the performance hit of producing this flag to when
682   it is actually needed. (Behdad Esfahbod)
683 - Documentation improvements. (Matthias Clasen)
685 - New API
686  - General:
687    +HB_BUFFER_FLAG_PRODUCE_UNSAFE_TO_CONCAT
688    +hb_var_num_t
690  - Draw:
691    +hb_draw_funcs_t
692    +hb_draw_funcs_create()
693    +hb_draw_funcs_reference()
694    +hb_draw_funcs_destroy()
695    +hb_draw_funcs_is_immutable()
696    +hb_draw_funcs_make_immutable()
697    +hb_draw_move_to_func_t
698    +hb_draw_funcs_set_move_to_func()
699    +hb_draw_line_to_func_t
700    +hb_draw_funcs_set_line_to_func()
701    +hb_draw_quadratic_to_func_t
702    +hb_draw_funcs_set_quadratic_to_func()
703    +hb_draw_cubic_to_func_t
704    +hb_draw_funcs_set_cubic_to_func()
705    +hb_draw_close_path_func_t
706    +hb_draw_funcs_set_close_path_func()
707    +hb_draw_state_t
708    +HB_DRAW_STATE_DEFAULT
709    +hb_draw_move_to()
710    +hb_draw_line_to()
711    +hb_draw_quadratic_to()
712    +hb_draw_cubic_to()
713    +hb_draw_close_path()
714    +hb_font_get_glyph_shape_func_t
715    +hb_font_funcs_set_glyph_shape_func()
716    +hb_font_get_glyph_shape()
718  - OpenType layout
719    +HB_OT_LAYOUT_BASELINE_TAG_IDEO_FACE_CENTRAL
720    +HB_OT_LAYOUT_BASELINE_TAG_IDEO_EMBOX_CENTRAL
721    +hb_ot_layout_get_horizontal_baseline_tag_for_script()
722    +hb_ot_layout_get_baseline_with_fallback()
724  - Metrics:
725    +hb_ot_metrics_get_position_with_fallback()
727  - Subset:
728    +hb_subset_plan_t
729    +hb_subset_plan_create_or_fail()
730    +hb_subset_plan_reference()
731    +hb_subset_plan_destroy()
732    +hb_subset_plan_set_user_data()
733    +hb_subset_plan_get_user_data()
734    +hb_subset_plan_execute_or_fail()
735    +hb_subset_plan_unicode_to_old_glyph_mapping()
736    +hb_subset_plan_new_to_old_glyph_mapping()
737    +hb_subset_plan_old_to_new_glyph_mapping()
740 Overview of changes leading to 3.4.0
741 Sunday, February 13, 2022
742 ====================================
743 - Perform sanity checks on shaping results is now part of “harfbuzz” library
744   and can be enabled by setting the buffer flag HB_BUFFER_FLAG_VERIFY.
745   (Behdad Esfahbod)
746 - Arabic Mark Transient Reordering Algorithm have been updated to revision 6.
747   (Khaled Hosny)
748 - ISO 15924 code for mathematical notation, ‘Zmth’, now maps to the OpenType
749   ‘math’ tag. (Alexis King)
750 - It is now possible to get at once all math kerning values for a given glyph
751   at a given corner. (Alexis King)
752 - Fix locale_t portability issues on systems the typedef’s it to a void
753   pointer. (Behdad Esfahbod)
755 - New API:
756 +HB_BUFFER_FLAG_VERIFY
757 +HB_OT_TAG_MATH_SCRIPT
758 +HB_SCRIPT_MATH
759 +hb_ot_math_kern_entry_t
760 +hb_ot_math_get_glyph_kernings()
762 - Deprecated API
763 +HB_OT_MATH_SCRIPT
766 Overview of changes leading to 3.3.2
767 Sunday, February 6, 2022
768 ====================================
769 - Revert splitting of pair positioning values introduced in 3.3.0 as it proved
770   problematic. (Behdad Esfahbod)
773 Overview of changes leading to 3.3.1
774 Monday, January 31, 2022
775 ====================================
776 - Fix heap-use-after-free in harfbuzz-subset introduced in previous release.
777   (Garret Rieger)
780 Overview of changes leading to 3.3.0
781 Monday, January 31, 2022
782 ====================================
783 - Improved documentation. (Matthias Clasen)
784 - Internal code cleanup, using C++ standard library more. (Behdad Esfahbod)
785 - The low 16-bits of face index will be used by hb_face_create() to select a
786   face inside a font collection file format, while the high 16-bits will be
787   used by hb_font_create() to load the named instance. (Behdad Esfahbod)
788 - Glyph positions and other font metrics now apply synthetic slant set by
789   hb_font_set_synthetic_slant(), for improved positioning for synthetically
790   slanted fonts. (Behdad Esfahbod)
791 - Fixed unintentional locale dependency in hb_variation_to_string() for decimal
792   point representation. (Matthias Clasen)
793 - When applying pair positioning (kerning) the positioning value is split
794   between the two sides of the pair for improved cursor positioning between
795   such pairs. (Behdad Esfahbod)
796 - Introduced new HB_GLYPH_FLAG_UNSAFE_TO_CONCAT, to be used in conjunction
797   with HB_GLYPH_FLAG_UNSAFE_TO_BREAK for optimizing re-shaping during line
798   breaking. Check the documentation for further details. (Behdad Esfahbod)
799 - Improved handling of macrolanguages when mapping BCP 47 codes to OpenType
800   tags. (David Corbett)
802 - New API:
803 +HB_GLYPH_FLAG_UNSAFE_TO_CONCAT
804 +hb_segment_properties_overlay()
805 +hb_buffer_create_similar()
806 +hb_font_set_synthetic_slant()
807 +hb_font_get_synthetic_slant()
808 +hb_font_get_var_coords_design()
811 Overview of changes leading to 3.2.0
812 Friday, November 26, 2021
813 ====================================
814 “harfbuzz” library improvements:
815 - Fixed shaping of Apple Color Emoji flags in right-to-left context. (Behdad Esfahbod)
816 - Fixed positioning of CFF fonts in HB_TINY profile. (Behdad Esfahbod)
817 - OpenType 1.9 language tags update. (David Corbett)
818 - Add HB_NO_VERTICAL config option.
819 - Add HB_CONFIG_OVERRIDE_H for easier configuration. (Behdad Esfahbod)
821 “harfbuzz-subset” library improvements:
822 - Improved packing of cmap, loca, and Ligature tables. (Garret Rieger)
823 - Significantly improved overflow-resolution strategy in the repacker. (Garret Rieger)
826 Overview of changes leading to 3.1.2
827 Friday, November 26, 2021
828 ====================================
829 - hb-shape / hb-view: revert treating text on the commandline as single
830   paragraph (was introduced in 3.0.0); add new --single-par to do that.
831   (Behdad Esfahbod)
832 - Subsetter bug fixes. (Garret Rieger, Qunxin Liu, Behdad Esfahbod)
835 Overview of changes leading to 3.1.1
836 Wednesday, November 8, 2021
837 ====================================
838 - Work around GCC cast-align error/warning on some platforms. (Behdad Esfahbod)
839 - Documentation improvements. (Matthias Clasen)
842 Overview of changes leading to 3.1.0
843 Wednesday, November 3, 2021
844 ====================================
845 - Better offset-overflow handling in the subsetter library. (Garret Rieger)
846 - Improved Unicode 14 properties in the USE shaper, and various other USE
847   shaper fixes. (David Corbett)
848 - MATH and COLR v1 tables subsetting support, and various other subsetter fixes.
849   (Qunxin Liu)
850 - Support for Pwo Karen / Ason Chin medial la. (Simon Cozens)
851 - Apply GPOS positioning when substituting with morx table, if kerx is missing.
852   (Behdad Esfahbod)
853 - Apply calt and clig features across syllable boundaries in Indic shaper.
854   (Behdad Esfahbod)
855 - meson option for enabling Graphite 2 has been renamed to graphite2.
856 - Build and documentation fixes.
858 - New API:
859 +hb_buffer_set_not_found_glyph()
860 +hb_buffer_get_not_found_glyph()
863 Overview of changes leading to 3.0.0
864 Friday, September 17, 2021
865 ====================================
866 - Unicode 14.0 support (David Corbett).
867 - The hb-subset API and the harfbuzz-subset library's ABI are now declared
868   stable. The harfbuzz-subset library would not have been possible without the
869   work of Garret Rieger and Qunxin Liu from Google Fonts, and the earlier work
870   of Michiharu Ariza from Adobe.
871 - The hb-style API is now stable and no longer experimental.
873 - New API:
874 +hb_style_tag_t
875 +hb_style_get_value()
876 +hb_subset_input_t
877 +hb_subset_flags_t
878 +hb_subset_sets_t
879 +hb_subset_input_create_or_fail()
880 +hb_subset_input_reference()
881 +hb_subset_input_destroy()
882 +hb_subset_input_set_user_data()
883 +hb_subset_input_get_user_data()
884 +hb_subset_input_unicode_set()
885 +hb_subset_input_glyph_set()
886 +hb_subset_input_set()
887 +hb_subset_input_get_flags()
888 +hb_subset_input_set_flags()
889 +hb_subset_or_fail()
891 - Removed old unstable harfbuzz-subset API:
892 -hb_subset_input_nameid_set()
893 -hb_subset_input_namelangid_set()
894 -hb_subset_input_layout_features_set()
895 -hb_subset_input_no_subset_tables_set()
896 -hb_subset_input_drop_tables_set()
897 -hb_subset_input_set_drop_hints()
898 -hb_subset_input_get_drop_hints()
899 -hb_subset_input_set_desubroutinize()
900 -hb_subset_input_get_desubroutinize()
901 -hb_subset_input_set_retain_gids()
902 -hb_subset_input_get_retain_gids()
903 -hb_subset_input_set_name_legacy()
904 -hb_subset_input_get_name_legacy()
905 -hb_subset_input_set_overlaps_flag()
906 -hb_subset_input_get_overlaps_flag()
907 -hb_subset_input_set_notdef_outline()
908 -hb_subset_input_get_notdef_outline()
909 -hb_subset_input_set_no_prune_unicode_ranges()
910 -hb_subset_input_get_no_prune_unicode_ranges()
911 -hb_subset()
914 Overview of changes leading to 2.9.1
915 Tuesday, September 7, 2021
916 ====================================
917 - Final subset API is in place and if no issues are discovered, it will be the
918   stable subset API of HarfBuzz 3.0.0. Old API is kept to ease transition, but
919   will be removed in 3.0.0.
920 - Various fuzzer-found bug fixes.
921 - hb_buffer_append() now handles the pre- and post-context which previously
922   were left unchanged in the destination buffer.
923 - hb-view / hb-shape now accept following new arguments:
924   o --unicodes-before/after: takes a list of hex numbers that represent Unicode
925     codepoints.
926 - Undeprecated API:
927   hb_set_invert()
930 Overview of changes leading to 2.9.0
931 Wednesday, August 18, 2021
932 History Repeats Itself (Afghanistan)
933 ====================================
934 - Subsetter API is being stabilized, with the first stable API to happen in
935   3.0.0 release (https://github.com/harfbuzz/harfbuzz/issues/3078).
936 - Support multiple variation axes with same tag, aka HOI.
937 - The “coretext” testing shaper now passes font variations to CoreText.
938 - hb-shape/hb-view does not break line at new lines unless text is read from
939   file.
940 - hb-view and hb-subset has a --batch now, similar to hb-shape.
941 - The --batch mode now uses ; as argument separator instead of : used previously.
942 - The --batch in hb-shape does not expect 0th argument anymore. That is, the
943   lines read are interpreted as argv[1:], instead of argv[0:].
944 - The --batch option has been undocumented. We are ready to document it; send
945   feedback if you find it useful.
946 - hb-subset got arguments revamps. Added much-requested --gids-file, --glyphs,
947   --glyphs-file, --unicodes-file, supporting ranges in --unicodes.
948 - Various bug fixes.
951 Overview of changes leading to 2.8.2
952 Tuesday, July 8, 2021
953 ====================================
954 - Shaping LTR digits for RTL scripts now makes the native direction of the
955   digits LTR, applying shaping and positioning rules on the same glyph order as
956   Uniscribe. (Jonathan Kew, Khaled Hosny).
957 - Subsetting COLR v1 and CPAL tables is now supported. (Garret Rieger, Qunxin Liu)
958 - Various fixes and improvements to the subsetter. (Garret Rieger, Qunxin Liu, Behdad)
959 - When applying morx table, mark glyph widths should not be zeroed. (Jonathan Kew)
960 - GPOS is preferred over kerx, if GSUB was applied. (Behdad)
961 - Regional_Indicator pairs are grouped together when clustering. (Behdad)
962 - New API:
963 +hb_blob_create_or_fail()
964 +hb_blob_create_from_file_or_fail()
965 +hb_set_copy()
968 Overview of changes leading to 2.8.1
969 Tuesday, May 4, 2021
970 ====================================
971 - Subsetter now fully supports GSUB/GPOS/GDEF tables (including variations); as
972   such, layout tables are retained by subsetter by default. (Garret Rieger, Qunxin Liu)
973 - Build scripts no longer check for FontConfig as HarfBuzz does not use it.
974 - hb-view supports iTerm2 and kitty inline image protocols (Khaled Hosny),
975   it can also use Chafa for terminal graphics if available (Hans Petter Jansson).
977 Overview of changes leading to 2.8.0
978 Tuesday, March 16, 2021
979 ====================================
980 - Shape joining scripts other than Arabic/Syriac using the Universal Shaping Engine.
981   Previously these were shaped using the generalized Arabic shaper. (David Corbett)
982 - Fix regression in shaping of U+0B55 ORIYA SIGN OVERLINE. (David Corbett)
983 - Update language tags. (David Corbett)
984 - Variations: reduce error: do not round each interpolated delta. (Just van Rossum)
985 - Documentation improvements. (Khaled Hosny, Nathan Willis)
986 - Subsetter improvements: subsets most, if not all, lookup types now. (Garret Rieger, Qunxin Liu)
987 - Fuzzer-found fixes and other improvements when memory failures happen. (Behdad)
988 - Removed most atomic implementations now that we have C++11 atomic impl. (Behdad)
989 - General codebase upkeep; using more C++11 features: constexpr constructors, etc. (Behdad)
992 Overview of changes leading to 2.7.4
993 Sunday, December 27, 2020
994 ====================================
995 - Fix missing --enable-introspection configure option from previous release
996   tarball.
997 - Documentation updates.
1000 Overview of changes leading to 2.7.3
1001 Wednesday, December 23, 2020
1002 ====================================
1003 - Update USE shaper to 2020-08-13 specification, and other improvements.
1004 - Don’t disable liga feature in myanmar shaper, to match Uniscribe.
1005 - Improvements to language and script tags handling.
1006 - Update language system tag registry to OpenType 1.8.4
1007 - Support for serializing and deserializing Unicode buffers. Serialized buffers
1008   are now delimited with `<>` or `[]` based on whether it is a Unicode or
1009   glyphs buffer.
1010 - Increase buffer work limits to handle fonts with many complex lookups.
1011 - Handle more shaping operations in trace output.
1012 - Memory access fixes.
1013 - More OOM fixes.
1014 - Improved documentation.
1015 - Build system improvements.
1016 - New API:
1017 +hb_buffer_has_positions()
1018 +hb_buffer_serialize()
1019 +hb_buffer_serialize_unicode()
1020 +hb_buffer_deserialize_unicode()
1023 Overview of changes leading to 2.7.2
1024 Saturday, August 29, 2020
1025 ====================================
1026 - Fix a regression in the previous release that caused a crash with Kaithi.
1027 - More OOM fixes.
1030 Overview of changes leading to 2.7.1
1031 Thursday, August 13, 2020
1032 ====================================
1033 - ot-funcs now handles variable empty glyphs better when hvar/vvar isn't present.
1034 - Reverted a GDEF processing regression.
1035 - A couple of fixes to handle OOM better.
1038 Overview of changes leading to 2.7.0
1039 Saturday, July 25, 2020
1040 ====================================
1041 - Use an implementation for round that always rounds up, some minor fluctuations
1042   are expected on var font specially when hb-ot callback is used.
1043 - Fix an AAT's `kerx` issue on broken rendering of Devanagari Sangam MN.
1044 - Remove AAT's `lcar` table support from _get_ligature_carets API, not even much
1045   use on macOS installed fonts (only two files).  GDEF support is the recommended
1046   one and expected to work properly after issues fixed two releases ago.
1047 - Minor memory fixes to handle OOM better specially in hb-ft.
1048 - Minor .so files versioning scheme change and remove stable/unstable scheme
1049   differences, was never used in practice (always default to stable scheme).
1050 - We are now suggesting careful packaging of the library using meson,
1051   https://github.com/harfbuzz/harfbuzz/wiki/Notes-on-migration-to-meson
1052   for more information.
1053 - Distribution package URL is changed, either use GitHub generated tarballs,
1054   `https://github.com/harfbuzz/harfbuzz/archive/$pkgver.tar.gz`
1055   or, even more preferably use commit hash of the release and git checkouts like,
1056   `git+https://github.com/harfbuzz/harfbuzz#commit=$commit`
1059 Overview of changes leading to 2.6.8
1060 Monday, June 22, 2020
1061 ====================================
1062 - New API to fetch glyph alternates from GSUB table.
1063 - hb-coretext build fix for macOS < 10.10.
1064 - Meson build fixes, cmake port removal is postponed but please prepare for
1065   it and give us feedback.
1066   Autotools is still our main build system however please consider
1067   experimenting with meson also for packaging the library.
1068 - New API:
1069 +hb_ot_layout_lookup_get_glyph_alternates()
1072 Overview of changes leading to 2.6.7
1073 Wednesday, June 3, 2020
1074 ====================================
1075 - Update to Unicode 13.0.0.
1076 - Fix hb_ot_layout_get_ligature_carets for fonts without lcar table, it was
1077   completely broken for all the other fonts since 2.1.2.
1078 - As a part of our migration to meson, this release will be the last one
1079   to provide cmake port files but autotools still is our main build system.
1080   There is a possibility that the next version or the after be released
1081   using meson.
1084 Overview of changes leading to 2.6.6
1085 Tuesday, May 12, 2020
1086 ====================================
1087 - A fix in AAT kerning for Geeza Pro.
1088 - Better support for resource fork fonts on macOS.
1091 Overview of changes leading to 2.6.5
1092 Friday, April 17, 2020
1093 ====================================
1094 - Add experimental meson build system.  Autotools is still the primary
1095   and supported build system.
1096 - AAT is now always preferred for horizontal scripts when both AAT and OT
1097   layout tables exist at the same time.
1098 - Subsetter improvements.
1099 - New API:
1100 +hb_ft_font_lock_face()
1101 +hb_ft_font_unlock_face()
1104 Overview of changes leading to 2.6.4
1105 Monday, October 29, 2019
1106 ====================================
1107 - Small bug fix.
1108 - Build fixes.
1111 Overview of changes leading to 2.6.3
1112 Monday, October 28, 2019
1113 ====================================
1114 - Misc small fixes, mostly to build-related issues.
1115 - New API:
1116 +hb_font_get_nominal_glyphs()
1119 Overview of changes leading to 2.6.2
1120 Monday, September 30, 2019
1121 ====================================
1122 - Misc small fixes, mostly to build-related issues.
1125 Overview of changes leading to 2.6.1
1126 Thursday, August 22, 2019
1127 ====================================
1128 - Fix regression with hb_font_create_sub_font scaling introduced in 2.6.0.
1129 - Change interpretation of font PTEM size / CoreText font size handling.
1130   See https://github.com/harfbuzz/harfbuzz/pull/1484
1131 - hb-ot-font: Prefer symbol cmap subtable if present.
1132 - Apply 'dist'/'abvm'/'blwm' features to all scripts.
1133 - Drop experimental DirectWrite API.
1136 Overview of changes leading to 2.6.0
1137 Tuesday, August 13, 2019
1138 ====================================
1139 - New OpenType metrics, baseline, and metadata table access APIs.
1140 - New API to set font variations to a named-instance.
1141 - New hb-gdi.h header and API for creating hb_face_t from HFONT.
1142 - Amalgam: Provide a single-file harfbuzz.cc file for easier alternate building.
1143 - More size-reduction configurable options, enabled by HB_TINY.
1144 - New API:
1145 +hb_font_set_var_named_instance()
1146 +hb_gdi_face_create()
1147 +hb_ot_layout_baseline_tag_t
1148 +hb_ot_layout_get_baseline()
1149 +hb_ot_meta_tag_t
1150 +hb_ot_meta_get_entry_tags()
1151 +hb_ot_meta_reference_entry()
1152 +hb_ot_metrics_tag_t
1153 +hb_ot_metrics_get_position()
1154 +hb_ot_metrics_get_variation()
1155 +hb_ot_metrics_get_x_variation()
1156 +hb_ot_metrics_get_y_variation()
1159 Overview of changes leading to 2.5.3
1160 Wednesday, June 26, 2019
1161 ====================================
1162 - Fix UCD script data for Unicode 10+ scripts.  This was broken since 2.5.0.
1163 - More optimizations for HB_TINY.
1166 Overview of changes leading to 2.5.2
1167 Thursday, June 20, 2019
1168 ====================================
1169 - More hb-config.hh facilities to shrink library size, namely when built as
1170   HB_TINY.
1171 - New documentation of custom configurations in CONFIG.md.
1172 - Fix build on gcc 4.8.  That's supported again.
1173 - Universal Shaping Engine improvements thanks to David Corbett.
1174 - API Changes: Undeprecate some horizontal-kerning API and re-enable in hb-ft,
1175   such that Type1 fonts will continue kerning.
1178 Overview of changes leading to 2.5.1
1179 Friday, May 31, 2019
1180 ====================================
1181 - Fix build with various versions of Visual Studio.
1182 - Improved documentation, thanks to Nathan Willis.
1183 - Bugfix in subsetting glyf table.
1184 - Improved scripts for cross-compiling for Windows using mingw.
1185 - Rename HB_MATH_GLYPH_PART_FLAG_EXTENDER to HB_OT_MATH_GLYPH_PART_FLAG_EXTENDER.
1186   A deprecated macro is added for backwards-compatibility.
1189 Overview of changes leading to 2.5.0
1190 Friday, May 24, 2019
1191 ====================================
1192 - This release does not include much functional changes, but includes major internal
1193   code-base changes.  We now require C++11.  Support for gcc 4.8 and earlier has been
1194   dropped.
1195 - New hb-config.hh facility for compiling smaller library for embedded and web usecases.
1196 - New Unicode Character Database implementation that is half the size of previously-used
1197   UCDN.
1198 - Subsetter improvements.
1199 - Improved documentation, thanks to Nathan Willis.
1200 - Misc shaping fixes.
1203 Overview of changes leading to 2.4.0
1204 Monday, March 25, 2019
1205 ====================================
1206 - Unicode 12.
1207 - Misc fixes.
1208 - Subsetter improvements.
1209 - New API:
1210 HB_BUFFER_FLAG_DO_NOT_INSERT_DOTTED_CIRCLE
1211 hb_directwrite_face_create()
1214 Overview of changes leading to 2.3.1
1215 Wednesday, January 30, 2019
1216 ====================================
1217 - AAT bug fixes.
1218 - Misc internal housekeeping cleanup.
1221 Overview of changes leading to 2.3.0
1222 Thursday, December 20, 2018
1223 ====================================
1224 - Fix regression on big-endian architectures.  Ouch!
1225 - Misc bug and build fixes.
1226 - Fix subsetting of simple GSUB/GDEF.
1227 - Merge CFF / CFF2 support contributed by Adobe.  This mostly involves
1228   the subsetter, but also get_glyph_extents on CFF fonts.
1230 New API in hb-aat.h:
1231 +hb_aat_layout_has_substitution()
1232 +hb_aat_layout_has_positioning()
1233 +hb_aat_layout_has_tracking()
1236 Overview of changes leading to 2.2.0
1237 Thursday, November 29, 2018
1238 ====================================
1239 - Misc shaping bug fixes.
1240 - Add font variations named-instance API.
1241 - Deprecate font variations axis enumeration API and add replacement.
1242 - AAT shaping improvements:
1243   o Fixed 'kern' table Format 2 implementation.
1244   o Implement 'feat' table API for feature detection.
1245   o Blacklist 'GSUB' table of fonts from 'MUTF' foundry that also have 'morx'.
1247 New API:
1248 +hb_aat_layout_feature_type_t
1249 +hb_aat_layout_feature_selector_t
1250 +hb_aat_layout_get_feature_types()
1251 +hb_aat_layout_feature_type_get_name_id
1252 +hb_aat_layout_feature_selector_info_t
1253 +HB_AAT_LAYOUT_NO_SELECTOR_INDEX
1254 +hb_aat_layout_feature_type_get_selector_infos()
1255 +hb_ot_var_axis_flags_t
1256 +hb_ot_var_axis_info_t
1257 +hb_ot_var_get_axis_infos()
1258 +hb_ot_var_find_axis_info()
1259 +hb_ot_var_get_named_instance_count()
1260 +hb_ot_var_named_instance_get_subfamily_name_id()
1261 +hb_ot_var_named_instance_get_postscript_name_id()
1262 +hb_ot_var_named_instance_get_design_coords()
1264 Deprecated API:
1265 +HB_OT_VAR_NO_AXIS_INDEX
1266 +hb_ot_var_axis_t
1267 +hb_ot_var_get_axes()
1268 +hb_ot_var_find_axis()
1271 Overview of changes leading to 2.1.3
1272 Friday, November 16, 2018
1273 ====================================
1274 - Fix AAT 'mort' shaping, which was broken in 2.1.2
1277 Overview of changes leading to 2.1.2
1278 Friday, November 16, 2018
1279 ====================================
1280 - Various internal changes.
1281 - AAT shaping improvements:
1282   o Implement kern table Format 1 state-machine-based kerning.
1283   o Implement cross-stream kerning (cursive positioning, etc).
1284   o Ignore emptyish GSUB tables (zero scripts) if morx present.
1285   o Don't apply GPOS if morx is being applied.  Matches Apple.
1288 -Overview of changes leading to 2.1.1
1289 Monday, November 5, 2018
1290 ====================================
1291 - AAT improvements:
1292   o Implement 'mort' table.
1293   o Implement 'kern' subtables Format 1 and Format 3.
1296 Overview of changes leading to 2.1.0
1297 Tuesday, October 30, 2018
1298 ====================================
1299 - AAT shaping improvements:
1300   o Allow user controlling AAT features, for whole buffer only currently.
1301   o Several 'morx' fixes.
1302   o Implement tuple-kerns in 'kerx'; Fixes kerning with Apple default
1303     San Francisco fonts.
1304 - Support for color fonts:
1305   o COLR/CPAL API to fetch color layers.
1306   o SVG table to fetch SVG documents.
1307   o CBDT/sbix API to fetch PNG images.
1308 - New 'name' table API.
1309 - hb-ot-font now uses 'VORG' table to correctly position CFF glyphs
1310   in vertical layout.
1311 - Various fuzzer-found bug fixes.
1313 Changed API:
1315 A type and a macro added in 2.0.0 were renamed:
1317 hb_name_id_t -> hb_ot_name_id_t
1318 HB_NAME_ID_INVALID -> HB_OT_NAME_ID_INVALID
1320 New API:
1322 +hb_color_t
1323 +HB_COLOR
1324 +hb_color_get_alpha()
1325 +hb_color_get_red()
1326 +hb_color_get_green()
1327 +hb_color_get_blue()
1328 +hb_ot_color_has_palettes()
1329 +hb_ot_color_palette_get_count()
1330 +hb_ot_color_palette_get_name_id()
1331 +hb_ot_color_palette_color_get_name_id()
1332 +hb_ot_color_palette_flags_t
1333 +hb_ot_color_palette_get_flags()
1334 +hb_ot_color_palette_get_colors()
1335 +hb_ot_color_has_layers()
1336 +hb_ot_color_layer_t
1337 +hb_ot_color_glyph_get_layers()
1338 +hb_ot_color_has_svg()
1339 +hb_ot_color_glyph_reference_svg()
1340 +hb_ot_color_has_png()
1341 +hb_ot_color_glyph_reference_png()
1343 +hb_ot_name_id_t
1344 +HB_OT_NAME_ID_INVALID
1345 +HB_OT_NAME_ID_COPYRIGHT
1346 +HB_OT_NAME_ID_FONT_FAMILY
1347 +HB_OT_NAME_ID_FONT_SUBFAMILY
1348 +HB_OT_NAME_ID_UNIQUE_ID
1349 +HB_OT_NAME_ID_FULL_NAME
1350 +HB_OT_NAME_ID_VERSION_STRING
1351 +HB_OT_NAME_ID_POSTSCRIPT_NAME
1352 +HB_OT_NAME_ID_TRADEMARK
1353 +HB_OT_NAME_ID_MANUFACTURER
1354 +HB_OT_NAME_ID_DESIGNER
1355 +HB_OT_NAME_ID_DESCRIPTION
1356 +HB_OT_NAME_ID_VENDOR_URL
1357 +HB_OT_NAME_ID_DESIGNER_URL
1358 +HB_OT_NAME_ID_LICENSE
1359 +HB_OT_NAME_ID_LICENSE_URL
1360 +HB_OT_NAME_ID_TYPOGRAPHIC_FAMILY
1361 +HB_OT_NAME_ID_TYPOGRAPHIC_SUBFAMILY
1362 +HB_OT_NAME_ID_MAC_FULL_NAME
1363 +HB_OT_NAME_ID_SAMPLE_TEXT
1364 +HB_OT_NAME_ID_CID_FINDFONT_NAME
1365 +HB_OT_NAME_ID_WWS_FAMILY
1366 +HB_OT_NAME_ID_WWS_SUBFAMILY
1367 +HB_OT_NAME_ID_LIGHT_BACKGROUND
1368 +HB_OT_NAME_ID_DARK_BACKGROUND
1369 +HB_OT_NAME_ID_VARIATIONS_PS_PREFIX
1370 +hb_ot_name_entry_t
1371 +hb_ot_name_list_names()
1372 +hb_ot_name_get_utf8()
1373 +hb_ot_name_get_utf16()
1374 +hb_ot_name_get_utf32()
1377 Overview of changes leading to 2.0.2
1378 Saturday, October 20, 2018
1379 ====================================
1380 - Fix two minor memory access issues in AAT tables.
1383 Overview of changes leading to 2.0.1
1384 Friday, October 19, 2018
1385 ====================================
1386 - Fix hb-version.h reported release version that went wrong (1.8.0)
1387   with previous release.
1388 - Fix extrapolation in 'trak' table.
1389 - Fix hb-font infinite-recursion issue with some font funcs and
1390   subclassed fonts.
1391 - Implement variation-kerning format in kerx table, although without
1392   variation.
1393 - Fix return value of hb_map_is_empty().
1396 Overview of changes leading to 2.0.0
1397 Thursday, October 18, 2018
1398 ====================================
1399 - Added AAT shaping support (morx/kerx/trak).
1400   Automatically used if GSUB/GPOS are not available respectively.
1401   Set HB_OPTIONS=aat env var to have morx/kerx preferred over
1402   GSUB/GPOS.
1403 - Apply TrueType kern table internally, instead of relying on
1404   hb_font_t callbacks.
1405 - Khmer shaper significantly rewritten to better match Uniscribe.
1406 - Indic3 tags ('dev3', etc) are passed to USE shaper.
1407 - .dfont Mac font containers implemented.
1408 - Script- and language-mapping revamped to better use BCP 47.
1409 - Misc USE and Indic fixes.
1410 - Misc everything fixes.
1411 - Too many things to list.  Biggest release since 0.9.1, with
1412   over 500 commits in just over 5 weeks!  Didn't intend it to
1413   be a big release.  Just happened to become.
1414 - hb-ft now locks underlying FT_Face during use.
1416 API changes:
1418 - Newly-created hb_font_t's now have our internal "hb-ot-font"
1419   callbacks set on them, so they should work out of the box
1420   without any callbacks set.  If callbacks are set, everything
1421   is back to what it was before, the fallback callbacks are
1422   null.  If you to get the internal implementation modified,
1423   sub_font it.
1425 - New hb_font_funcs_set_nominal_glyphs_func() allows speeding
1426   up character to glyph mapping.
1428 New API:
1429 +HB_FEATURE_GLOBAL_START
1430 +HB_FEATURE_GLOBAL_END
1431 +hb_buffer_set_invisible_glyph()
1432 +hb_buffer_get_invisible_glyph()
1433 +hb_font_funcs_set_nominal_glyphs_func()
1434 +hb_ot_layout_table_select_script()
1435 +hb_ot_layout_script_select_language()
1436 +hb_ot_layout_feature_get_name_ids()
1437 +hb_ot_layout_feature_get_characters()
1438 +hb_name_id_t
1439 +HB_NAME_ID_INVALID
1440 +HB_OT_MAX_TAGS_PER_SCRIPT
1441 +hb_ot_tags_from_script_and_language()
1442 +hb_ot_tags_to_script_and_language()
1444 Deprecated API:
1445 -hb_font_funcs_set_glyph_func()
1446 -hb_unicode_eastasian_width_func_t
1447 -hb_unicode_funcs_set_eastasian_width_func()
1448 -hb_unicode_eastasian_width()
1449 -hb_unicode_decompose_compatibility_func_t
1450 -HB_UNICODE_MAX_DECOMPOSITION_LEN
1451 -hb_unicode_funcs_set_decompose_compatibility_func()
1452 -hb_unicode_decompose_compatibility()
1453 -hb_font_funcs_set_glyph_h_kerning_func()
1454 -hb_font_funcs_set_glyph_v_kerning_func()
1455 -hb_font_get_glyph_h_kerning()
1456 -hb_font_get_glyph_v_kerning()
1457 -hb_font_get_glyph_kerning_for_direction()
1458 -hb_ot_layout_table_choose_script()
1459 -hb_ot_layout_script_find_language()
1460 -hb_ot_tags_from_script()
1461 -hb_ot_tag_from_language()
1464 Overview of changes leading to 1.9.0
1465 Monday, September 10, 2018
1466 ====================================
1467 - Added 'cmap' API to hb_face_t.
1468 - Face-builder API.
1469 - hb-ot-font re-creation should be much leaner now, as the
1470   font tables it uses are cached on hb_face_t now.
1471 - Internal source header file name changes:
1472   hb-*-private.hh is renamed to hb-*.hh.
1474 New API:
1475 +HB_UNICODE_MAX
1476 +hb_face_collect_unicodes()
1477 +hb_face_collect_variation_selectors()
1478 +hb_face_collect_variation_unicodes()
1479 +hb_face_builder_create()
1480 +hb_face_builder_add_table()
1483 Overview of changes leading to 1.8.8
1484 Tuesday, August 14, 2018
1485 ====================================
1486 - Fix hb-icu crash on architectures where compare_exchange_weak() can
1487   fail falsely.  This bug was introduced in 1.8.4.
1488   https://bugs.chromium.org/p/chromium/issues/detail?id=873568
1489 - More internal refactoring of atomic operations and singletons.
1490 - API changes:
1491   The following functions do NOT reference their return value before
1492   returning:
1493   * hb_unicode_funcs_get_default()
1494   * hb_glib_get_unicode_funcs()
1495   * hb_icu_get_unicode_funcs()
1496   This is consistent with their naming ("get", instead of "reference")
1497   as well as how they are used in the wild (ie. no one calls destroy()
1498   on their return value.)
1501 Overview of changes leading to 1.8.7
1502 Wednesday, August 8, 2018
1503 ====================================
1504 - Fix assertion failure with GDEF-blacklisted fonts.
1507 Overview of changes leading to 1.8.6
1508 Tuesday, August 7, 2018
1509 ====================================
1510 - Internal code shuffling.
1511 - New API to speed up getting advance widths for implementations
1512   that have heavy overhead in get_h_advance callback:
1513 +hb_font_funcs_set_glyph_h_advances_func
1514 +hb_font_funcs_set_glyph_v_advances_func
1515 +hb_font_get_glyph_advances_for_direction
1516 +hb_font_get_glyph_h_advances
1517 +hb_font_get_glyph_h_advances_func_t
1518 +hb_font_get_glyph_v_advances
1519 +hb_font_get_glyph_v_advances_func_t
1522 Overview of changes leading to 1.8.5
1523 Wednesday, August 1, 2018
1524 ====================================
1525 - Major Khmer shaper improvements to better match Microsoft.
1526 - Indic bug fixes.
1527 - Internal improvements to atomic operations.
1530 Overview of changes leading to 1.8.4
1531 Tuesday, July 17, 2018
1532 ====================================
1533 - Fix build on non-C++11.
1534 - Use C++-style GCC atomics and C++11 atomics.
1537 Overview of changes leading to 1.8.3
1538 Wednesday, July 11, 2018
1539 ====================================
1540 - A couple of Indic / USE bug fixes.
1541 - Disable vectorization, as it was causing unaligned access bus error on
1542   certain 32bit architectures.
1545 Overview of changes leading to 1.8.2
1546 Tuesday, July 3, 2018
1547 ====================================
1548 - Fix infinite loop in Khmer shaper.
1549 - Improve hb_blob_create_from_file() for streams.
1552 Overview of changes leading to 1.8.1
1553 Tuesday, June 12, 2018
1554 ====================================
1555 - Fix hb-version.h file generation; last two releases went out with wrong ones.
1556 - Add correctness bug in hb_set_t operations, introduced in 1.7.7.
1557 - Remove HB_SUBSET_BUILTIN build option.  Not necessary.
1560 Overview of changes leading to 1.8.0
1561 Tuesday, June 5, 2018
1562 ====================================
1563 - Update to Unicode 11.0.0.
1566 Overview of changes leading to 1.7.7
1567 Tuesday, June 5, 2018
1568 ====================================
1569 - Lots of internal changes, but not yet exposed externally.
1570 - All HarfBuzz objects are significantly smaller in size now.
1571 - Sinhala: Position repha on top of post-consonant, not base.
1572   This better matches Windows 10 behavior, which was changed
1573   from previous Windows versions.
1574 - New build options:
1575   o New cpp macro HB_NO_ATEXIT
1576   o New cpp macro HB_SUBSET_BUILTIN
1577 - Significant libharfbuzz-subset changes. API subject to change.
1578 - New API in libharfbuzz:
1580 +hb_blob_create_from_file()
1581 +hb_face_count()
1583 A hashmap implementation:
1584 +hb-map.h
1585 +HB_MAP_VALUE_INVALID
1586 +hb_map_t
1587 +hb_map_create()
1588 +hb_map_get_empty()
1589 +hb_map_reference()
1590 +hb_map_destroy()
1591 +hb_map_set_user_data()
1592 +hb_map_get_user_data()
1593 +hb_map_allocation_successful()
1594 +hb_map_clear()
1595 +hb_map_is_empty()
1596 +hb_map_get_population()
1597 +hb_map_set()
1598 +hb_map_get()
1599 +hb_map_del()
1600 +hb_map_has()
1603 Overview of changes leading to 1.7.6
1604 Wednesday, March 7, 2018
1605 ====================================
1607 - Fix to hb_set_t binary operations. Ouch.
1608 - New experimental harfbuzz-subset library. All of hb-subset.h
1609   is experimental right now and API WILL change.
1611 - New API:
1612 hb_blob_copy_writable_or_fail()
1613 HB_OT_TAG_BASE
1614 hb_set_previous()
1615 hb_set_previous_range()
1618 Overview of changes leading to 1.7.5
1619 Tuesday, January 30, 2018
1620 ====================================
1622 - Separate Khmer shaper from Indic.
1623 - First stab at AAT morx. Not hooked up.
1624 - Misc bug fixes.
1627 Overview of changes leading to 1.7.4
1628 Wednesday, December 20, 2017
1629 ====================================
1631 - Fix collect_glyphs() regression caused by hb_set_t changes.
1634 Overview of changes leading to 1.7.3
1635 Monday, December 18, 2017
1636 ====================================
1638 - hb_set_t performance tuning and optimizations.
1639 - Speed up collect_glyphs() and reject garbage data.
1640 - In hb_coretext_font_create() set font point-size (ptem).
1641 - Misc fixes.
1644 Overview of changes leading to 1.7.2
1645 Monday, December 4, 2017
1646 ====================================
1648 - Optimize hb_set_add_range().
1649 - Misc fixes.
1650 - New API:
1651 hb_coretext_font_create()
1654 Overview of changes leading to 1.7.1
1655 Tuesday, November 14, 2017
1656 ====================================
1658 - Fix atexit object destruction regression.
1659 - Fix minor integer-overflow.
1662 Overview of changes leading to 1.7.0
1663 Monday, November 13, 2017
1664 ====================================
1666 - Minor Indic fixes.
1667 - Implement kerning and glyph names in hb-ot-font.
1668 - Various DSO optimization re .data and .bss sizes.
1669 - Make C++11 optional; build fixes.
1670 - Mark all other backends "unsafe-to-break".
1671 - Graphite fix.
1674 Overview of changes leading to 1.6.3
1675 Thursday, October 26th, 2017
1676 ====================================
1678 - Fix hb_set_t some more.  Should be solid now.
1679 - Implement get_glyph_name() for hb-ot-font.
1680 - Misc fixes.
1683 Overview of changes leading to 1.6.2
1684 Monday, October 23nd, 2017
1685 ====================================
1687 - Yesterday's release had a bad crasher; don't use it.  That's what
1688   happens when one works on Sunday...
1689   https://github.com/harfbuzz/harfbuzz/issues/578
1690 - Build fixes for FreeBSD and Chrome Android.
1693 Overview of changes leading to 1.6.1
1694 Sunday, October 22nd, 2017
1695 ====================================
1697 - Don't skip over COMBINING GRAPHEME JOINER when ligating, etc.
1698   To be refined: https://github.com/harfbuzz/harfbuzz/issues/554
1699 - Faster hb_set_t implementation.
1700 - Don't use deprecated ICU API.
1701 - Fix undefined-behavior in Myanmar shaper, introduced in 1.6.0
1702 - Deprecated API:
1703   hb_set_invert()
1706 Overview of changes leading to 1.6.0
1707 Friday, October the 13th, 2017
1708 ====================================
1710 - Update to Unicode 10.
1712 - Various Indic and Universal Shaping Engine fixes as a result of
1713   HarfBuzz Hackfest with Jonathan Kew at Web Engines Hackfest at
1714   the Igalia offices in A Coruña, Spain.  Thanks Igalia for having
1715   us!
1717 - Implement Unicode Arabic Mark Ordering Algorithm UTR#53.
1719 - Implement optical sizing / tracking in CoreText backend, using
1720   new API hb_font_set_ptem().
1722 - Allow notifying hb_font_t that underlying FT_Face changed sizing,
1723   using new API hb_ft_font_changed().
1725 - More Graphite backend RTL fixes.
1727 - Fix caching of variable font shaping plans.
1729 - hb-view / hb-shape now accept following new arguments:
1731   o --unicodes: takes a list of hex numbers that represent Unicode
1732     codepoints.
1734 New API:
1735 +hb_face_get_table_tags()
1736 +hb_font_set_ptem()
1737 +hb_font_get_ptem()
1738 +hb_ft_font_changed()
1741 Overview of changes leading to 1.5.1
1742 Tuesday, September 5, 2017
1743 ====================================
1745 - Fix "unsafe-to-break" in fallback shaping and other corner cases.
1746   All our tests pass with --verify now, meaning unsafe-to-break API
1747   works as expected.
1748 - Add --unicodes to hb-view / hb-shape.
1749 - [indic] Treat Consonant_With_Stacker as consonant.  This will need
1750   further tweaking.
1751 - hb_buffer_diff() tweaks.
1754 Overview of changes leading to 1.5.0
1755 Wednesday, August 23, 2017
1756 ====================================
1758 - Misc new API, for appending a buffer to another, and for comparing
1759   contents of two buffers for types of differences.
1761 - New "unsafe-to-break" API.  Can be used to speed up reshaping
1762   in line-breaking situations.  Essentially, after shaping, it returns
1763   positions in the input string (some of the cluster boundaries) that
1764   are "safe to break" in that if the text is segmented at that position
1765   and two sides reshaped and concatenated, the shaping result is
1766   exactly the same as shaping the text in one piece.
1768   hb-view and hb-shape and hb-shape now take --verify, which verifies
1769   the above property.
1771   Some corner cases of the implementation are still not quite working.
1772   Those will be fixed in subsequent releases.
1774 - New API:
1776 hb_buffer_append()
1778 hb_glyph_flags_t
1779 HB_GLYPH_FLAG_UNSAFE_TO_BREAK
1780 HB_GLYPH_FLAG_DEFINED
1781 hb_glyph_info_get_glyph_flags()
1783 HB_BUFFER_SERIALIZE_FLAG_GLYPH_FLAGS
1785 hb_buffer_diff_flags_t
1786 HB_BUFFER_DIFF_FLAG_EQUAL
1787 HB_BUFFER_DIFF_FLAG_CONTENT_TYPE_MISMATCH
1788 HB_BUFFER_DIFF_FLAG_LENGTH_MISMATCH
1789 HB_BUFFER_DIFF_FLAG_NOTDEF_PRESENT
1790 HB_BUFFER_DIFF_FLAG_DOTTED_CIRCLE_PRESENT
1791 HB_BUFFER_DIFF_FLAG_CODEPOINT_MISMATCH
1792 HB_BUFFER_DIFF_FLAG_CLUSTER_MISMATCH
1793 HB_BUFFER_DIFF_FLAG_GLYPH_FLAGS_MISMATCH
1794 HB_BUFFER_DIFF_FLAG_POSITION_MISMATCH
1795 hb_buffer_diff
1798 Overview of changes leading to 1.4.8
1799 Tuesday, August 8, 2017
1800 ====================================
1802 - Major fix to avar table handling.
1803 - Rename hb-shape --show-message to --trace.
1804 - Build fixes.
1807 Overview of changes leading to 1.4.7
1808 Tuesday, July 18, 2017
1809 ====================================
1811 - Multiple Indic, Tibetan, and Cham fixes.
1812 - CoreText: Allow disabling kerning.
1813 - Adjust Arabic feature order again.
1814 - Misc build fixes.
1817 Overview of changes leading to 1.4.6
1818 Sunday, April 23, 2017
1819 ====================================
1821 - Graphite2: Fix RTL positioning issue.
1822 - Backlist GDEF of more versions of Padauk and Tahoma.
1823 - New, experimental, cmake alternative build system.
1826 Overview of changes leading to 1.4.5
1827 Friday, March 10, 2017
1828 ====================================
1830 - Revert "Fix Context lookup application when moving back after a glyph..."
1831   This introduced memory access problems.  To be fixed properly soon.
1834 Overview of changes leading to 1.4.4
1835 Sunday, March 5, 2017
1836 ====================================
1838 - Fix Context lookup application when moving back after a glyph deletion.
1839 - Fix buffer-overrun in Bengali.
1842 Overview of changes leading to 1.4.3
1843 Saturday, February 25, 2017
1844 ====================================
1846 - Route Adlam script to Arabic shaper.
1847 - Misc fixes.
1848 - New API:
1849   hb_font_set_face()
1850 - Deprecate API:
1851   hb_graphite2_font_get_gr_font()
1854 Overview of changes leading to 1.4.2
1855 Monday, January 23, 2017
1856 ====================================
1858 - Implement OpenType Font Variation tables avar/fvar/HVAR/VVAR.
1859 - hb-shape and hb-view now accept --variations.
1860 - New API:
1862 hb_variation_t
1863 hb_variation_from_string()
1864 hb_variation_to_string()
1866 hb_font_set_variations()
1867 hb_font_set_var_coords_design()
1868 hb_font_get_var_coords_normalized()
1870 hb-ot-var.h:
1871 hb_ot_var_axis_t
1872 hb_ot_var_has_data()
1873 hb_ot_var_get_axis_count()
1874 hb_ot_var_get_axes()
1875 hb_ot_var_find_axis()
1876 hb_ot_var_normalize_variations()
1877 hb_ot_var_normalize_coords()
1879 - MVAR to be implemented later.  Access to named instances to be
1880   implemented later as well.
1882 - Misc fixes.
1885 Overview of changes leading to 1.4.1
1886 Thursday, January 5, 2017
1887 ====================================
1889 - Always build and use UCDN for Unicode data by default.
1890   Reduces dependence on version of Unicode data in glib,
1891   specially in the Windows bundles we are shipping, which
1892   have very old glib.
1895 Overview of changes leading to 1.4.0
1896 Thursday, January 5, 2017
1897 ====================================
1899 - Merged "OpenType GX" branch which adds core of support for
1900   OpenType 1.8 Font Variations.  To that extent, the relevant
1901   new API is:
1903 New API:
1904 hb_font_set_var_coords_normalized()
1906   with supporting API:
1908 New API:
1909 HB_OT_LAYOUT_NO_VARIATIONS_INDEX
1910 hb_ot_layout_table_find_feature_variations()
1911 hb_ot_layout_feature_with_variations_get_lookups()
1912 hb_shape_plan_create2()
1913 hb_shape_plan_create_cached2()
1915   Currently variations in GSUB/GPOS/GDEF are fully supported,
1916   and no other tables are supported.  In particular, fvar/avar
1917   are NOT supported, hence the hb_font_set_var_coords_normalized()
1918   taking normalized coordinates.  API to take design coordinates
1919   will be added in the future.
1921   HVAR/VVAR/MVAR support will also be added to hb-ot-font in the
1922   future.
1924 - Fix regression in GDEF glyph class processing.
1925 - Add decompositions for Chakma, Limbu, and Balinese in USE shaper.
1926 - Misc fixes.
1929 Overview of changes leading to 1.3.4
1930 Monday, December 5, 2016
1931 ====================================
1933 - Fix vertical glyph origin in hb-ot-font.
1934 - Implement CBDT/CBLC color font glyph extents in hb-ot-font.
1937 Overview of changes leading to 1.3.3
1938 Wednesday, September 28, 2016
1939 ====================================
1941 - Implement parsing of OpenType MATH table.
1942 New API:
1943 HB_OT_TAG_MATH
1944 HB_OT_MATH_SCRIPT
1945 hb_ot_math_constant_t
1946 hb_ot_math_kern_t
1947 hb_ot_math_glyph_variant_t
1948 hb_ot_math_glyph_part_flags_t
1949 hb_ot_math_glyph_part_t
1950 hb_ot_math_has_data
1951 hb_ot_math_get_constant
1952 hb_ot_math_get_glyph_italics_correction
1953 hb_ot_math_get_glyph_top_accent_attachment
1954 hb_ot_math_get_glyph_kerning
1955 hb_ot_math_is_glyph_extended_shape
1956 hb_ot_math_get_glyph_variants
1957 hb_ot_math_get_min_connector_overlap
1958 hb_ot_math_get_glyph_assembly
1961 Overview of changes leading to 1.3.2
1962 Wednesday, September 27, 2016
1963 ====================================
1965 - Fix build of hb-coretext on older OS X versions.
1968 Overview of changes leading to 1.3.1
1969 Wednesday, September 7, 2016
1970 ====================================
1972 - Blacklist bad GDEF of more fonts (Padauk).
1973 - More CoreText backend crash fixes with OS X 10.9.5.
1974 - Misc fixes.
1977 Overview of changes leading to 1.3.0
1978 Thursday, July 21, 2016
1979 ====================================
1981 - Update to Unicode 9.0.0
1982 - Move Javanese from Indic shaper to Universal Shaping Engine.
1983 - Allow MultipleSubst to delete a glyph (matching Windows engine).
1984 - Update Universal Shaping Engine to latest draft from Microsoft.
1985 - DirectWrite backend improvements.  Note: this backend is for testing ONLY.
1986 - CoreText backend improvements with unreachable fonts.
1987 - Implement symbol fonts (cmap 3.0.0) in hb-ft and hb-ot-font.
1988 - Blacklist bad GDEF of more fonts (Tahoma & others).
1989 - Misc fixes.
1992 Overview of changes leading to 1.2.7
1993 Monday, May 2, 2016
1994 ====================================
1996 - Blacklist another version of Times New Roman (Bold) Italic from Windows 7.
1997 - Fix Mongolian Free Variation Selectors shaping with certain fonts.
1998 - Fix Tibetan shorthand contractions shaping.
1999 - Improved list of language tag mappings.
2000 - Unbreak build on Windows CE.
2001 - Make 'glyf' table loading lazy in hb-ot-font.
2004 Overview of changes leading to 1.2.6
2005 Friday, April 8, 2016
2006 ====================================
2008 - Blacklist GDEF table of another set of Times New Roman (Bold) Italic.
2009 - DirectWrite backend improvements.  Note: DirectWrite backend is
2010   exclusively for our internal testing and should NOT be used in any
2011   production system whatsoever.
2014 Overview of changes leading to 1.2.5
2015 Monday, April 4, 2016
2016 ====================================
2018 - Fix GDEF mark-filtering-set, which was broken in 1.2.3.
2021 Overview of changes leading to 1.2.4
2022 Thursday, March 17, 2016
2023 ====================================
2025 - Synthesize GDEF glyph class for any glyph that does not have one in GDEF.
2026   I really hope we don't discover broken fonts that shape badly with this
2027   change.
2028 - Misc build and other minor fixes.
2029 - API changes:
2030   - Added HB_NDEBUG.  It's fine for production systems to define this to
2031     disable high-overhead debugging checks.  However, I also reduced the
2032     overhead of those checks, so it's a non-issue right now.  You can
2033     forget it.  Just not defining anything at all is fine.
2036 Overview of changes leading to 1.2.3
2037 Thursday, February 25, 2016
2038 ====================================
2040 - Blacklist GDEF table of certain versions of Times New Roman (Bold) Italic,
2041   due to bug in glyph class of ASCII double-quote character.  This should
2042   address "regression" introduced in 1.2.0 when we switched mark zeroing
2043   in most shapers from BY_UNICODE_LATE to BY_GDEF_LATE.
2044   This fourth release in a week should finally stabilize things...
2046 - hb-ot-font's get_glyph() implementation saw some optimizations.  Though,
2047   might be really hard to measure in real-world situations.
2049 - Also, two rather small API changes:
2051 We now disable some time-consuming internal bookkeeping if built with NDEBUG
2052 defined.  This is a first time that we use NDEBUG to disable debug code.  If
2053 there exist production systems that do NOT want to enable NDEBUG, please let
2054 me know and I'll add HB_NDEBUG.
2056 Added get_nominal_glyph() and get_variation_glyph() instead of get_glyph()
2058 New API:
2059 - hb_font_get_nominal_glyph_func_t
2060 - hb_font_get_variation_glyph_func_t
2061 - hb_font_funcs_set_nominal_glyph_func()
2062 - hb_font_funcs_set_variation_glyph_func()
2063 - hb_font_get_nominal_glyph()
2064 - hb_font_get_variation_glyph()
2066 Deprecated API:
2067 - hb_font_get_glyph_func_t
2068 - hb_font_funcs_set_glyph_func()
2070 Clients that implement their own font-funcs are encouraged to replace
2071 their get_glyph() implementation with a get_nominal_glyph() and
2072 get_variation_glyph() pair.  The variation version can assume that
2073 variation_selector argument is not zero.  Old (deprecated) functions
2074 will continue working indefinitely using internal gymnastics; it is
2075 just more efficient to use the new functions.
2078 Overview of changes leading to 1.2.2
2079 Wednesday, February 24, 2016
2080 ====================================
2082 - Fix regression with mark positioning with fonts that have
2083   non-zero mark advances.  This was introduced in 1.2.0 while
2084   trying to make mark and cursive attachments to work together.
2085   I have partially reverted that, so this version is much more
2086   like what we had before.  All clients who updated to 1.2.0
2087   should update to this version.
2090 Overview of changes leading to 1.2.1
2091 Tuesday, February 23, 2016
2092 ====================================
2094 - CoreText: Fix bug with wrong scale if font scale was changed later.
2095   https://github.com/libass/libass/issues/212
2096 - CoreText: Drastically speed up font initialization.
2097 - CoreText: Fix tiny leak.
2098 - Group ZWJ/ZWNJ with previous syllable under cluster-level=0.
2099   https://github.com/harfbuzz/harfbuzz/issues/217
2100 - Add test/shaping/README.md about how to add tests to the suite.
2103 Overview of changes leading to 1.2.0
2104 Friday, February 19, 2016
2105 ====================================
2107 - Fix various issues (hangs mostly) in case of memory allocation failure.
2108 - Change mark zeroing types of most shapers from BY_UNICODE_LATE to
2109   BY_GDEF_LATE.  This seems to be what Uniscribe does.
2110 - Change mark zeroing of USE shaper from NONE to BY_GDEF_EARLY.  That's
2111   what Windows does.
2112 - Allow GPOS cursive connection on marks, and fix the interaction with
2113   mark attachment.  This work resulted in some changes to how mark
2114   attachments work.  See:
2115   https://github.com/harfbuzz/harfbuzz/issues/211
2116   https://github.com/harfbuzz/harfbuzz/commit/86c68c7a2c971efe8e35b1f1bd99401dc8b688d2
2117 - Graphite2 shaper: improved negative advance handling (eg. Nastaliq).
2118 - Add nmake-based build system for Windows.
2119 - Minor speedup.
2120 - Misc. improvements.
2123 Overview of changes leading to 1.1.3
2124 Monday, January 11, 2016
2125 ====================================
2127 - Ported Indic shaper to Unicode 8.0 data.
2128 - Universal Shaping Engine fixes.
2129 - Speed up CoreText shaper when font fallback happens in CoreText.
2130 - Documentation improvements, thanks to Khaled Hosny.
2131 - Very rough directwrite shaper for testing, thanks to Ebrahim Byagowi.
2132 - Misc bug fixes.
2133 - New API:
2135   * Font extents:
2136       hb_font_extents_t
2137       hb_font_get_font_extents_func_t
2138       hb_font_get_font_h_extents_func_t
2139       hb_font_get_font_v_extents_func_t
2140       hb_font_funcs_set_font_h_extents_func
2141       hb_font_funcs_set_font_v_extents_func
2142       hb_font_get_h_extents
2143       hb_font_get_v_extents
2144       hb_font_get_extents_for_direction
2146   * Buffer message (aka debug):
2147       hb_buffer_message_func_t
2148       hb_buffer_set_message_func()
2149     Actual message protocol to be fleshed out later.
2152 Overview of changes leading to 1.1.2
2153 Wednesday, November 26, 2015
2154 ====================================
2156 - Fix badly-broken fallback shaper that affected terminology.
2157   https://github.com/harfbuzz/harfbuzz/issues/187
2158 - Fix y_scaling in Graphite shaper.
2159 - API changes:
2160   * An unset glyph_h_origin() function in font-funcs now (sensibly)
2161     implies horizontal origin at 0,0.  Ie, the nil callback returns
2162     true instead of false.  As such, implementations that have a
2163     glyph_h_origin() that simply returns true, can remove that function
2164     with HarfBuzz >= 1.1.2.  This results in a tiny speedup.
2167 Overview of changes leading to 1.1.1
2168 Wednesday, November 24, 2015
2169 ====================================
2171 - Build fixes, specially for hb-coretext.
2174 Overview of changes leading to 1.1.0
2175 Wednesday, November 18, 2015
2176 ====================================
2178 - Implement 'stch' stretch feature for Syriac Abbreviation Mark.
2179   https://github.com/harfbuzz/harfbuzz/issues/141
2180 - Disable use of decompose_compatibility() callback.
2181 - Implement "shaping" of various Unicode space characters, even
2182   if the font does not support them.
2183   https://github.com/harfbuzz/harfbuzz/issues/153
2184 - If font does not support U+2011 NO-BREAK HYPHEN, fallback to
2185   U+2010 HYPHEN.
2186 - Changes resulting from libFuzzer continuous fuzzing:
2187   * Reject font tables that need more than 8 edits,
2188   * Bound buffer growth during shaping to 32x,
2189   * Fix assertions and other issues at OOM / buffer max-growth.
2190 - Misc fixes and optimizations.
2191 - API changes:
2192   * All fonts created with hb_font_create() now inherit from
2193     (ie. have parent) hb_font_get_empty().
2196 Overview of changes leading to 1.0.6
2197 Thursday, October 15, 2015
2198 ====================================
2200 - Reduce max nesting level in OT lookups from 8 to 6.
2201   Should not affect any real font as far as I know.
2202 - Fix memory access issue in ot-font.
2203 - Revert default load-flags of fonts created using hb_ft_font_create()
2204   back to FT_LOAD_DEFAULT|FT_LOAD_NO_HINTING.  This was changed in
2205   last release (1.0.5), but caused major issues, so revert.
2206   https://github.com/harfbuzz/harfbuzz/issues/143
2209 Overview of changes leading to 1.0.5
2210 Tuesday, October 13, 2015
2211 ====================================
2213 - Fix multiple memory access bugs discovered using libFuzzer.
2214   https://github.com/harfbuzz/harfbuzz/issues/139
2215   Everyone should upgrade to this version as soon as possible.
2216   We now have continuous fuzzing set up, to avoid issues like
2217   these creeping in again.
2218 - Misc fixes.
2220 - New API:
2221   * hb_font_set_parent().
2222   * hb_ft_font_[sg]et_load_flags()
2223     The default flags for fonts created using hb_ft_font_create()
2224     has changed to default to FT_LOAD_DEFAULT now.  Previously it
2225     was defaulting to FT_LOAD_DFEAULT|FT_LOAD_NO_HINTING.
2227 - API changes:
2228   * Fonts now default to units-per-EM as their scale, instead of 0.
2229   * hb_font_create_sub_font() does NOT make parent font immutable
2230     anymore.  hb_font_make_immutable() does.
2233 Overview of changes leading to 1.0.4
2234 Wednesday, September 30, 2015
2235 ====================================
2237 - Fix minor out-of-bounds read error.
2240 Overview of changes leading to 1.0.3
2241 Tuesday, September 1, 2015
2242 ====================================
2244 - Start of user documentation, from Simon Cozens!
2245 - Implement glyph_extents() for TrueType fonts in hb-ot-font.
2246 - Improve GPOS cursive attachments with conflicting lookups.
2247 - More fixes for cluster-level = 1.
2248 - Uniscribe positioning fix.
2251 Overview of changes leading to 1.0.2
2252 Wednesday, August 19, 2015
2253 ====================================
2255 - Fix shaping with cluster-level > 0.
2256 - Fix Uniscribe backend font-size scaling.
2257 - Declare dependencies in harfbuzz.pc.
2258   FreeType is not declared though, to avoid bugs in pkg-config
2259   0.26 with recursive dependencies.
2260 - Slightly improved debug infrastructure.  More to come later.
2261 - Misc build fixes.
2264 Overview of changes leading to 1.0.1
2265 Monday, July 27, 2015
2266 ====================================
2268 - Fix out-of-bounds access in USE shaper.
2271 Overview of changes leading to 1.0.0
2272 Sunday, July 26, 2015
2273 ====================================
2275 - Implement Universal Shaping Engine:
2276   https://www.microsoft.com/typography/OpenTypeDev/USE/intro.htm
2277   http://blogs.windows.com/bloggingwindows/2015/02/23/windows-shapes-the-worlds-languages/
2278 - Bump version to 1.0.0.  The soname was NOT bumped.
2281 Overview of changes leading to 0.9.42
2282 Thursday, July 26, 2015
2283 =====================================
2285 - New API to allow for retrieving finer-grained cluster
2286   mappings if the client desires to handle them.  Default
2287   behavior is unchanged.
2288 - Fix cluster merging when removing default-ignorables.
2289 - Update to Unicode 8.0
2290 - hb-graphite2 fixes.
2291 - Misc fixes.
2292 - Removed HB_NO_MERGE_CLUSTERS hack.
2293 - New API:
2294   hb_buffer_cluster_level_t enum
2295   hb_buffer_get_cluster_level()
2296   hb_buffer_set_cluster_level()
2297   hb-shape / hb-view --cluster-level
2300 Overview of changes leading to 0.9.41
2301 Thursday, June 18, 2015
2302 =====================================
2304 - Fix hb-coretext with trailing whitespace in right-to-left.
2305 - New API: hb_buffer_reverse_range().
2306 - Allow implementing atomic ops in config.h.
2307 - Fix hb_language_t in language bindings.
2308 - Misc fixes.
2311 Overview of changes leading to 0.9.40
2312 Friday, March 20, 2015
2313 =====================================
2315 - Another hb-coretext crasher fix.  Ouch!
2316 - Happy Norouz!
2319 Overview of changes leading to 0.9.39
2320 Wednesday, March 4, 2015
2321 =====================================
2323 - Critical hb-coretext fixes.
2324 - Optimizations and refactoring; no functional change
2325   expected.
2326 - Misc build fixes.
2329 Overview of changes leading to 0.9.38
2330 Friday, January 23, 2015
2331 =====================================
2333 - Fix minor out-of-bounds access in Indic shaper.
2334 - Change New Tai Lue shaping engine from South-East Asian to default,
2335   reflecting change in Unicode encoding model.
2336 - Add hb-shape --font-size.  Can take up to two numbers for separate
2337   x / y size.
2338 - Fix CoreText and FreeType scale issues with negative scales.
2339 - Reject blobs larger than 2GB.  This might break some icu-le-hb clients
2340   that need security fixes.  See:
2341   http://www.icu-project.org/trac/ticket/11450
2342 - Avoid accessing font tables during face destruction, in casce rogue
2343   clients released face data already.
2344 - Fix up gobject-introspection a bit.  Python bindings kinda working.
2345   See README.python.
2346 - Misc fixes.
2347 - API additions:
2348   hb_ft_face_create_referenced()
2349   hb_ft_font_create_referenced()
2352 Overview of changes leading to 0.9.37
2353 Wednesday, December 17, 2014
2354 =====================================
2356 - Fix out-of-bounds access in Context lookup format 3.
2357 - Indic: Allow ZWJ/ZWNJ before syllable modifiers.
2360 Overview of changes leading to 0.9.36
2361 Thursday, November 20, 2014
2362 =====================================
2364 - First time that three months went by without a release since
2365   0.9.2 was released on August 10, 2012!
2366 - Fix performance bug in hb_ot_collect_glyphs():
2367   https://bugzilla.mozilla.org/show_bug.cgi?id=1090869
2368 - Add basic vertical-text support to hb-ot-font.
2369 - Misc build fixes.
2372 Overview of changes leading to 0.9.35
2373 Saturday, August 13, 2014
2374 =====================================
2376 - Fix major shape-plan caching bug when more than one shaper were
2377   provided to hb_shape_full() (as exercised by XeTeX).
2378   http://www.mail-archive.com/debian-bugs-dist@lists.debian.org/msg1246370.html
2379 - Fix Arabic fallback shaping regression.  This was broken in 0.9.32.
2380 - Major hb-coretext fixes.  That backend is complete now, including
2381   respecing buffer direction and language, down to vertical writing.
2382 - Build fixes for Windows CE.  Should build fine now.
2383 - Misc fixes:
2384   Use atexit() only if it's safe to call from shared library
2385   https://bugs.freedesktop.org/show_bug.cgi?id=82246
2386   Mandaic had errors in its Unicode Joining_Type
2387   https://bugs.freedesktop.org/show_bug.cgi?id=82306
2388 - API changes:
2390   * hb_buffer_clear_contents() does not reset buffer flags now.
2392     After 763e5466c0a03a7c27020e1e2598e488612529a7, one doesn't
2393     need to set flags for different pieces of text.  The flags now
2394     are something the client sets up once, depending on how it
2395     actually uses the buffer.  As such, don't clear it in
2396     clear_contents().
2398     I don't expect any changes to be needed to any existing client.
2401 Overview of changes leading to 0.9.34
2402 Saturday, August 2, 2014
2403 =====================================
2405 - hb_feature_from_string() now accepts CSS font-feature-settings format.
2406 - As a result, hb-shape / hb-view --features also accept CSS-style strings.
2407   Eg, "'liga' off" is accepted now.
2408 - Add old-spec Myanmar shaper:
2409   https://bugs.freedesktop.org/show_bug.cgi?id=81775
2410 - Don't apply 'calt' in Hangul shaper.
2411 - Fix mark advance zeroing for Hebrew shaper:
2412   https://bugs.freedesktop.org/show_bug.cgi?id=76767
2413 - Implement Windows-1256 custom Arabic shaping.  Only built on Windows,
2414   and requires help from get_glyph().  Used by Firefox.
2415   https://bugzilla.mozilla.org/show_bug.cgi?id=1045139
2416 - Disable 'liga' in vertical text.
2417 - Build fixes.
2418 - API changes:
2420   * Make HB_BUFFER_FLAG_BOT/EOT easier to use.
2422     Previously, we expected users to provide BOT/EOT flags when the
2423     text *segment* was at paragraph boundaries.  This meant that for
2424     clients that provide full paragraph to HarfBuzz (eg. Pango), they
2425     had code like this:
2427       hb_buffer_set_flags (hb_buffer,
2428                            (item_offset == 0 ? HB_BUFFER_FLAG_BOT : 0) |
2429                            (item_offset + item_length == paragraph_length ?
2430                             HB_BUFFER_FLAG_EOT : 0));
2432       hb_buffer_add_utf8 (hb_buffer,
2433                           paragraph_text, paragraph_length,
2434                           item_offset, item_length);
2436     After this change such clients can simply say:
2438       hb_buffer_set_flags (hb_buffer,
2439                            HB_BUFFER_FLAG_BOT | HB_BUFFER_FLAG_EOT);
2441       hb_buffer_add_utf8 (hb_buffer,
2442                           paragraph_text, paragraph_length,
2443                           item_offset, item_length);
2445     Ie, HarfBuzz itself checks whether the segment is at the beginning/end
2446     of the paragraph.  Clients that only pass item-at-a-time to HarfBuzz
2447     continue not setting any flags whatsoever.
2449     Another way to put it is: if there's pre-context text in the buffer,
2450     HarfBuzz ignores the BOT flag.  If there's post-context, it ignores
2451     EOT flag.
2454 Overview of changes leading to 0.9.33
2455 Tuesday, July 22, 2014
2456 =====================================
2458 - Turn off ARabic 'cswh' feature that was accidentally turned on.
2459 - Add HB_TAG_MAX_SIGNED.
2460 - Make hb_face_make_immutable() really make face immutable!
2461 - Windows build fixes.
2464 Overview of changes leading to 0.9.32
2465 Thursday, July 17, 2014
2466 =====================================
2468 - Apply Arabic shaping features in spec order exactly.
2469 - Another fix for Mongolian free variation selectors.
2470 - For non-Arabic scripts in Arabic shaper apply 'rlig' and 'calt'
2471   together.
2472 - Minor adjustment to U+FFFD logic.
2473 - Fix hb-coretext build.
2476 Overview of changes leading to 0.9.31
2477 Wednesday, July 16, 2014
2478 =====================================
2480 - Only accept valid UTF-8/16/32; we missed many cases before.
2481 - Better shaping of invalid UTF-8/16/32.  Falls back to
2482   U+FFFD REPLACEMENT CHARACTER now.
2483 - With all changes in this release, the buffer will contain fully
2484   valid Unicode after hb_buffer_add_utf8/16/32 no matter how
2485   broken the input is.  This can be overridden though.  See below.
2486 - Fix Mongolian Variation Selectors for fonts without GDEF.
2487 - Fix minor invalid buffer access.
2488 - Accept zh-Hant and zh-Hans language tags.  hb_ot_tag_to_language()
2489   now uses these instead of private tags.
2490 - Build fixes.
2491 - New API:
2492   * hb_buffer_add_codepoints().  This does what hb_buffer_add_utf32()
2493     used to do, ie. no validity check on the input at all.  add_utf32
2494     now replaces invalid Unicode codepoints with the replacement
2495     character (see below).
2496   * hb_buffer_set_replacement_codepoint()
2497   * hb_buffer_get_replacement_codepoint()
2498     Previously, in hb_buffer_add_utf8 and hb_buffer_add_utf16, when
2499     we detected broken input, we replaced that with (hb_codepoint_t)-1.
2500     This has changed to use U+FFFD now, but can be changed using these
2501     new API.
2504 Overview of changes leading to 0.9.30
2505 Wednesday, July 9, 2014
2506 =====================================
2508 - Update to Unicode 7.0.0:
2509   * New scripts Manichaean and Psalter Pahlavi are shaped using
2510     Arabic shaper.
2511   * All the other new scripts to through the generic shaper for
2512     now.
2513 - Minor Indic improvements.
2514 - Fix graphite2 backend cluster mapping [crasher!]
2515 - API changes:
2516   * New HB_SCRIPT_* values for Unicode 7.0 scripts.
2517   * New function hb_ot_layout_language_get_required_feature().
2518 - Build fixes.
2521 Overview of changes leading to 0.9.29
2522 Thursday, May 29, 2014
2523 =====================================
2525 - Implement cmap in hb-ot-font.h.  No variation-selectors yet.
2526 - Myanmar: Allow MedialYa+Asat.
2527 - Various Indic fixes:
2528   * Support most characters in Extended Devanagary and Vedic
2529     Unicode blocks.
2530   * Allow digits and a some punctuation as consonant placeholders.
2531 - Build fixes.
2534 Overview of changes leading to 0.9.28
2535 Monday, April 28, 2014
2536 =====================================
2538 - Unbreak old-spec Indic shaping. (bug 76705)
2539 - Fix shaping of U+17DD and U+0FC6.
2540 - Add HB_NO_MERGE_CLUSTERS build option.  NOT to be enabled by default
2541   for shipping libraries.  It's an option for further experimentation
2542   right now.  When we are sure how to do it properly, we will add
2543   public run-time API for the functionality.
2544 - Build fixes.
2547 Overview of changes leading to 0.9.27
2548 Tuesday, March 18, 2014
2549 =====================================
2551 - Don't use "register" storage class specifier
2552 - Wrap definition of free_langs() with HAVE_ATEXIT
2553 - Add coretext_aat shaper and hb_coretext_face_create() constructor
2554 - If HAVE_ICU_BUILTIN is defined, use hb-icu Unicode callbacks
2555 - Add Myanmar test case from OpenType Myanmar spec
2556 - Only do fallback Hebrew composition if no GPOS 'mark' available
2557 - Allow bootstrapping without gtk-doc
2558 - Use AM_MISSING_PROG for ragel and git
2559 - Typo in ucdn's Makefile.am
2560 - Improve MemoryBarrier() implementation
2563 Overview of changes leading to 0.9.26
2564 Thursday, January 30, 2014
2565 =====================================
2567 - Misc fixes.
2568 - Fix application of 'rtlm' feature.
2569 - Automatically apply frac/numr/dnom around U+2044 FRACTION SLASH.
2570 - New header: hb-ot-shape.h
2571 - Uniscribe: fix scratch-buffer accounting.
2572 - Reorder Tai Tham SAKOT to after tone-marks.
2573 - Add Hangul shaper.
2574 - New files:
2575   hb-ot-shape-complex-hangul.cc
2576   hb-ot-shape-complex-hebrew.cc
2577   hb-ot-shape-complex-tibetan.cc
2578 - Disable 'cswh' feature in Arabic shaper.
2579 - Coretext: better handle surrogate pairs.
2580 - Add HB_TAG_MAX and _HB_SCRIPT_MAX_VALUE.
2583 Overview of changes leading to 0.9.25
2584 Wednesday, December 4, 2013
2585 =====================================
2587 - Myanmar shaper improvements.
2588 - Avoid font fallback in CoreText backend.
2589 - Additional OpenType language tag mappiongs.
2590 - More aggressive shape-plan caching.
2591 - Build with / require automake 1.13.
2592 - Build with libtool 2.4.2.418 alpha to support ppc64le.
2595 Overview of changes leading to 0.9.24
2596 Tuesday, November 13, 2013
2597 =====================================
2599 - Misc compiler warning fixes with clang.
2600 - No functional changes.
2603 Overview of changes leading to 0.9.23
2604 Monday, October 28, 2013
2605 =====================================
2607 - "Udupi HarfBuzz Hackfest", Paris, October 14..18 2013.
2608 - Fix (Chain)Context recursion with non-monotone lookup positions.
2609 - Misc Indic bug fixes.
2610 - New Javanese / Buginese shaping, similar to Windows 8.1.
2613 Overview of changes leading to 0.9.22
2614 Thursday, October 3, 2013
2615 =====================================
2617 - Fix use-after-end-of-scope in hb_language_from_string().
2618 - Fix hiding of default_ignorables if font doesn't have space glyph.
2619 - Protect against out-of-range lookup indices.
2621 - API Changes:
2623   * Added hb_ot_layout_table_get_lookup_count()
2626 Overview of changes leading to 0.9.21
2627 Monday, September 16, 2013
2628 =====================================
2630 - Rename gobject-introspection library name from harfbuzz to HarfBuzz.
2631 - Remove (long disabled) hb-old and hb-icu-le test shapers.
2632 - Misc gtk-doc and gobject-introspection annotations.
2633 - Misc fixes.
2634 - API changes:
2636   * Add HB_SET_VALUE_INVALID
2638 Overview of changes leading to 0.9.20
2639 Thursday, August 29, 2013
2640 =====================================
2642 General:
2643 - Misc substitute_closure() fixes.
2644 - Build fixes.
2646 Documentation:
2647 - gtk-doc boilerplate integrated.  Docs are built now, but
2648   contain no contents.  By next release hopefully we have
2649   some content in.  Enable using --enable-gtk-doc.
2651 GObject and Introspection:
2652 - Added harfbuzz-gobject library (hb-gobject.h) that has type
2653   bindings for all HarfBuzz objects and enums.  Enable using
2654   --with-gobject.
2655 - Added gobject-introspection boilerplate.  Nothing useful
2656   right now.  Work in progress.  Gets enabled automatically if
2657   --with-gobject is used.  Override with --disable-introspection.
2659 OpenType shaper:
2660 - Apply 'mark' in Myanmar shaper.
2661 - Don't apply 'dlig' by default.
2663 Uniscribe shaper:
2664 - Support user features.
2665 - Fix loading of fonts that are also installed on the system.
2666 - Fix shaping of Arabic Presentation Forms.
2667 - Fix build with wide chars.
2669 CoreText shaper:
2670 - Support user features.
2672 Source changes:
2673 - hb_face_t code moved to hb-face.h / hb-face.cc.
2674 - Added hb-deprecated.h.
2676 API changes:
2677 - Added HB_DISABLE_DEPRECATED.
2678 - Deprecated HB_SCRIPT_CANADIAN_ABORIGINAL; replaced by
2679   HB_SCRIPT_CANADIAN_SYLLABICS.
2680 - Deprecated HB_BUFFER_FLAGS_DEFAULT; replaced by
2681   HB_BUFFER_FLAG_DEFAULT.
2682 - Deprecated HB_BUFFER_SERIALIZE_FLAGS_DEFAULT; replaced by
2683   HB_BUFFER_SERIALIZE_FLAG_DEFAULT.
2686 Overview of changes leading to 0.9.19
2687 Tuesday, July 16, 2013
2688 =====================================
2690 - Build fixes.
2691 - Better handling of multiple variation selectors in a row.
2692 - Pass on variation selector to GSUB if not consumed by cmap.
2693 - Fix undefined memory access.
2694 - Add Javanese config to Indic shaper.
2695 - Misc bug fixes.
2697 Overview of changes leading to 0.9.18
2698 Tuesday, May 28, 2013
2699 =====================================
2701 New build system:
2703 - All unneeded code is all disabled by default,
2705 - Uniscribe and CoreText shapers can be enabled with their --with options,
2707 - icu_le and old shapers cannot be enabled for now,
2709 - glib, freetype, and cairo will be detected automatically.
2710   They can be force on/off'ed with their --with options,
2712 - icu and graphite2 are default off, can be enabled with their --with
2713   options,
2715 Moreover, ICU support is now build into a separate library:
2716 libharfbuzz-icu.so, and a new harfbuzz-icu.pc is shipped for it.
2717 Distros can enable ICU now without every application on earth
2718 getting linked to via libharfbuzz.so.
2720 For distros I recommend that they make sure they are building --with-glib
2721 --with-freetype --with-cairo, --with-icu, and optionally --with-graphite2;
2722 And package harfbuzz and harfbuzz-icu separately.
2725 Overview of changes leading to 0.9.17
2726 Monday, May 20, 2013
2727 =====================================
2729 - Build fixes.
2730 - Fix bug in hb_set_get_min().
2731 - Fix regression with Arabic mark positioning / width-zeroing.
2733 Overview of changes leading to 0.9.16
2734 Friday, April 19, 2013
2735 =====================================
2737 - Major speedup in OpenType lookup processing.  With the Amiri
2738   Arabic font, this release is over 3x faster than previous
2739   release.  All scripts / languages should see this speedup.
2741 - New --num-iterations option for hb-shape / hb-view; useful for
2742   profiling.
2744 Overview of changes leading to 0.9.15
2745 Friday, April 05, 2013
2746 =====================================
2748 - Build fixes.
2749 - Fix crasher in graphite2 shaper.
2750 - Fix Arabic mark width zeroing regression.
2751 - Don't compose Hangul jamo into Unicode syllables.
2754 Overview of changes leading to 0.9.14
2755 Thursday, March 21, 2013
2756 =====================================
2758 - Build fixes.
2759 - Fix time-consuming sanitize with malicious fonts.
2760 - Implement hb_buffer_deserialize_glyphs() for both json and text.
2761 - Do not ignore Hangul filler characters.
2762 - Indic fixes:
2763   * Fix Malayalam pre-base reordering interaction with post-forms.
2764   * Further adjust ZWJ handling.  Should fix known regressions from
2765     0.9.13.
2768 Overview of changes leading to 0.9.13
2769 Thursday, February 25, 2013
2770 =====================================
2772 - Build fixes.
2773 - Ngapi HarfBuzz Hackfest in London (February 2013):
2774   * Fixed all known Indic bugs,
2775   * New Win8-style Myanmar shaper,
2776   * New South-East Asian shaper for Tai Tham, Cham, and New Tai Lue,
2777   * Smartly ignore Default_Ignorable characters (joiners, etc) wheb
2778     matching GSUB/GPOS lookups,
2779   * Fix 'Phags-Pa U+A872 shaping,
2780   * Fix partial disabling of default-on features,
2781   * Allow disabling of TrueType kerning.
2782 - Fix possible crasher with broken fonts with overlapping tables.
2783 - Removed generated files from git again.  So, one needs ragel to
2784   bootstrap from the git tree.
2786 API changes:
2787 - hb_shape() and related APIs now abort if buffer direction is
2788   HB_DIRECTION_INVALID.  Previously, hb_shape() was calling
2789   hb_buffer_guess_segment_properties() on the buffer before
2790   shaping.  The heuristics in that function are fragile.  If the
2791   user really wants the old behvaior, they can call that function
2792   right before calling hb_shape() to get the old behavior.
2793 - hb_blob_create_sub_blob() always creates sub-blob with
2794   HB_MEMORY_MODE_READONLY.  See comments for the reason.
2797 Overview of changes leading to 0.9.12
2798 Thursday, January 18, 2013
2799 =====================================
2801 - Build fixes for Sun compiler.
2802 - Minor bug fix.
2804 Overview of changes leading to 0.9.11
2805 Thursday, January 10, 2013
2806 =====================================
2808 - Build fixes.
2809 - Fix GPOS mark attachment with null Anchor offsets.
2810 - [Indic] Fix old-spec reordering of viramas if sequence ends in one.
2811 - Fix multi-threaded shaper data creation crash.
2812 - Add atomic ops for Solaris.
2814 API changes:
2815 - Rename hb_buffer_clear() to hb_buffer_clear_contents().
2818 Overview of changes leading to 0.9.10
2819 Thursday, January 3, 2013
2820 =====================================
2822 - [Indic] Fixed rendering of Malayalam dot-reph
2823 - Updated OT language tags.
2824 - Updated graphite2 backend.
2825 - Improved hb_ot_layout_get_size_params() logic.
2826 - Improve hb-shape/hb-view help output.
2827 - Fixed hb-set.h implementation to not crash.
2828 - Fixed various issues with hb_ot_layout_collect_lookups().
2829 - Various build fixes.
2831 New API:
2833 hb_graphite2_face_get_gr_face()
2834 hb_graphite2_font_get_gr_font()
2835 hb_coretext_face_get_cg_font()
2837 Modified API:
2839 hb_ot_layout_get_size_params()
2842 Overview of changes leading to 0.9.9
2843 Wednesday, December 5, 2012
2844 ====================================
2846 - Fix build on Windows.
2847 - Minor improvements.
2850 Overview of changes leading to 0.9.8
2851 Tuesday, December 4, 2012
2852 ====================================
2855 - Actually implement hb_shape_plan_get_shaper ().
2856 - Make UCDB data tables const.
2857 - Lots of internal refactoring in OTLayout tables.
2858 - Flesh out hb_ot_layout_lookup_collect_glyphs().
2860 New API:
2862 hb_ot_layout_collect_lookups()
2863 hb_ot_layout_get_size_params()
2866 Overview of changes leading to 0.9.7
2867 Sunday, November 21, 2012
2868 ====================================
2871 HarfBuzz "All-You-Can-Eat-Sushi" (aka Vancouver) Hackfest and follow-on fixes.
2873 - Fix Arabic contextual joining using pre-context text.
2874 - Fix Sinhala "split matra" mess.
2875 - Fix Khmer shaping with broken fonts.
2876 - Implement Thai "PUA" shaping for old fonts.
2877 - Do NOT route Kharoshthi script through the Indic shaper.
2878 - Disable fallback positioning for Indic and Thai shapers.
2879 - Misc fixes.
2882 hb-shape / hb-view changes:
2884 - Add --text-before and --text-after
2885 - Add --bot / --eot / --preserve-default-ignorables
2886 - hb-shape --output-format=json
2889 New API:
2891 hb_buffer_clear()
2893 hb_buffer_flags_t
2895 HB_BUFFER_FLAGS_DEFAULT
2896 HB_BUFFER_FLAG_BOT
2897 HB_BUFFER_FLAG_EOT
2898 HB_BUFFER_FLAG_PRESERVE_DEFAULT_IGNORABLES
2900 hb_buffer_set_flags()
2901 hb_buffer_get_flags()
2903 HB_BUFFER_SERIALIZE_FLAGS
2904 hb_buffer_serialize_glyphs()
2905 hb_buffer_deserialize_glyphs()
2906 hb_buffer_serialize_list_formats()
2908 hb_set_add_range()
2909 hb_set_del_range()
2910 hb_set_get_population()
2911 hb_set_next_range()
2913 hb_face_[sg]et_glyph_count()
2915 hb_segment_properties_t
2916 HB_SEGMENT_PROPERTIES_DEFAULT
2917 hb_segment_properties_equal()
2918 hb_segment_properties_hash()
2920 hb_buffer_set_segment_properties()
2921 hb_buffer_get_segment_properties()
2923 hb_ot_layout_glyph_class_t
2924 hb_ot_layout_get_glyph_class()
2925 hb_ot_layout_get_glyphs_in_class()
2927 hb_shape_plan_t
2928 hb_shape_plan_create()
2929 hb_shape_plan_create_cached()
2930 hb_shape_plan_get_empty()
2931 hb_shape_plan_reference()
2932 hb_shape_plan_destroy()
2933 hb_shape_plan_set_user_data()
2934 hb_shape_plan_get_user_data()
2935 hb_shape_plan_execute()
2936 hb_shape_plan_get_shaper()
2938 hb_ot_shape_plan_collect_lookups()
2941 API changes:
2943 - Remove "mask" parameter from hb_buffer_add().
2944 - Rename hb_ot_layout_would_substitute_lookup() and hb_ot_layout_substitute_closure_lookup().
2945 - hb-set.h API const correction.
2946 - Renamed hb_set_min/max() to hb_set_get_min/max().
2947 - Rename hb_ot_layout_feature_get_lookup_indexes() to hb_ot_layout_feature_get_lookups().
2948 - Rename hb_buffer_guess_properties() to hb_buffer_guess_segment_properties().
2952 Overview of changes leading to 0.9.6
2953 Sunday, November 13, 2012
2954 ====================================
2956 - Don't clear pre-context text if no new context is provided.
2957 - Fix ReverseChainingSubstLookup, which was totally borked.
2958 - Adjust output format of hb-shape a bit.
2959 - Include config.h.in in-tree.  Makes it easier for alternate build systems.
2960 - Fix hb_buffer_set_length(buffer, 0) invalid memory allocation.
2961 - Use ICU LayoutEngine's C API instead of C++.  Avoids much headache.
2962 - Drop glyphs for all of Unicode Default_Ignorable characters.
2963 - Misc build fixes.
2965 Arabic shaper:
2966 - Enable 'dlig' and 'mset' features in Arabic shaper.
2967 - Implement 'Phags-pa shaping, improve Mongolian.
2969 Indic shaper:
2970 - Decompose Sinhala split matras the way old HarfBuzz / Pango did.
2971 - Initial support for Consonant Medials.
2972 - Start adding new-style Myanmar shaping.
2973 - Make reph and 'pref' logic introspect the font.
2974 - Route Meetei-Mayek through the Indic shaper.
2975 - Don't apply 'liga' in Indic shaper.
2976 - Improve Malayalam pre-base reordering Ra interaction with Chillus.
2980 Overview of changes leading to 0.9.5
2981 Sunday, October 14, 2012
2982 ====================================
2984 - Synthetic-GSUB Arabic fallback shaping.
2986 - Misc Indic improvements.
2988 - Add build system support for pthread.
2990 - Imported UCDN for in-tree Unicode callbacks implementation.
2992 - Context-aware Arabic joining.
2994 - Misc other fixes.
2996 - New API:
2998   hb_feature_to/from-string()
2999   hb_buffer_[sg]et_content_type()
3003 Overview of changes leading to 0.9.4
3004 Tuesday, Sep 03, 2012
3005 ====================================
3007 - Indic improvements with old-spec Malayalam.
3009 - Better fallback glyph positioning, specially with Thai / Lao marks.
3011 - Implement dotted-circle insertion.
3013 - Better Arabic fallback shaping / ligation.
3015 - Added ICU LayoutEngine backend for testing.  Call it by the 'icu_le' name.
3017 - Misc fixes.
3021 Overview of changes leading to 0.9.3
3022 Friday, Aug 18, 2012
3023 ====================================
3025 - Fixed fallback mark positioning for left-to-right text.
3027 - Improve mark positioning for the remaining combining classes.
3029 - Unbreak Thai and fallback Arabic shaping.
3031 - Port Arabic shaper to shape-plan caching.
3033 - Use new ICU normalizer functions.
3037 Overview of changes leading to 0.9.2
3038 Friday, Aug 10, 2012
3039 ====================================
3041 - Over a thousand commits!  This is the first major release of HarfBuzz.
3043 - HarfBuzz is feature-complete now!  It should be in par, or better, than
3044   both Pango's shapers and old HarfBuzz / Qt shapers.
3046 - New Indic shaper, supporting main Indic scripts, Sinhala, and Khmer.
3048 - Improved Arabic shaper, with fallback Arabic shaping, supporting Arabic,
3049   Sinhala, N'ko, Mongolian, and Mandaic.
3051 - New Thai / Lao shaper.
3053 - Tibetan / Hangul support in the generic shaper.
3055 - Synthetic GDEF support for fonts without a GDEF table.
3057 - Fallback mark positioning for fonts without a GPOS table.
3059 - Unicode normalization shaping heuristic during glyph mapping.
3061 - New experimental Graphite2 backend.
3063 - New Uniscribe backend (primarily for testing).
3065 - New CoreText backend (primarily for testing).
3067 - Major optimization and speedup.
3069 - Test suites and testing infrastructure (work in progress).
3071 - Greatly improved hb-view cmdline tool.
3073 - hb-shape cmdline tool.
3075 - Unicode 6.1 support.
3077 Summary of API changes:
3079 o Changed API:
3081   - Users are expected to only include main header files now (ie. hb.h,
3082     hb-glib.h, hb-ft.h, ...)
3084   - All struct tag names had their initial underscore removed.
3085     Ie. "struct _hb_buffer_t" is "struct hb_buffer_t" now.
3087   - All set_user_data() functions now take a "replace" boolean parameter.
3089   - hb_buffer_create() takes zero arguments now.
3090     Use hb_buffer_pre_allocate() to pre-allocate.
3092   - hb_buffer_add_utf*() now accept -1 for length parameters,
3093     meaning "nul-terminated".
3095   - hb_direction_t enum values changed.
3097   - All *_from_string() APIs now take a length parameter to allow for
3098     non-nul-terminated strings. A -1 length means "nul-terminated".
3100   - Typedef for hb_language_t changed.
3102   - hb_get_table_func_t renamed to hb_reference_table_func_t.
3104   - hb_ot_layout_table_choose_script()
3106   - Various renames in hb-unicode.h.
3108 o New API:
3110   - hb_buffer_guess_properties()
3111     Automatically called by hb_shape().
3113   - hb_buffer_normalize_glyphs()
3115   - hb_tag_from_string()
3117   - hb-coretext.h
3119   - hb-uniscribe.h
3121   - hb_face_reference_blob()
3122   - hb_face_[sg]et_index()
3123   - hb_face_set_upem()
3125   - hb_font_get_glyph_name_func_t
3126     hb_font_get_glyph_from_name_func_t
3127     hb_font_funcs_set_glyph_name_func()
3128     hb_font_funcs_set_glyph_from_name_func()
3129     hb_font_get_glyph_name()
3130     hb_font_get_glyph_from_name()
3131     hb_font_glyph_to_string()
3132     hb_font_glyph_from_string()
3134   - hb_font_set_funcs_data()
3136   - hb_ft_font_set_funcs()
3137   - hb_ft_font_get_face()
3139   - hb-gobject.h (work in progress)
3141   - hb_ot_shape_glyphs_closure()
3142     hb_ot_layout_substitute_closure_lookup()
3144   - hb-set.h
3146   - hb_shape_full()
3148   - hb_unicode_combining_class_t
3150   - hb_unicode_compose_func_t
3151     hb_unicode_decompose_func_t
3152     hb_unicode_decompose_compatibility_func_t
3153     hb_unicode_funcs_set_compose_func()
3154     hb_unicode_funcs_set_decompose_func()
3155     hb_unicode_funcs_set_decompose_compatibility_func()
3156     hb_unicode_compose()
3157     hb_unicode_decompose()
3158     hb_unicode_decompose_compatibility()
3160 o Removed API:
3162   - hb_ft_get_font_funcs()
3164   - hb_ot_layout_substitute_start()
3165     hb_ot_layout_substitute_lookup()
3166     hb_ot_layout_substitute_finish()
3167     hb_ot_layout_position_start()
3168     hb_ot_layout_position_lookup()
3169     hb_ot_layout_position_finish()
3173 Overview of changes leading to 0.6.0
3174 Friday, May 27, 2011
3175 ====================================
3177 - Vertical text support in GPOS
3178 - Almost all API entries have unit tests now, under test/
3179 - All thread-safety issues are fixed
3181 Summary of API changes follows.
3184 * Simple Types API:
3186   o New API:
3187     HB_LANGUAGE_INVALID
3188     hb_language_get_default()
3189     hb_direction_to_string()
3190     hb_direction_from_string()
3191     hb_script_get_horizontal_direction()
3192     HB_UNTAG()
3194   o Renamed API:
3195     hb_category_t renamed to hb_unicode_general_category_t
3197   o Changed API:
3198     hb_language_t is a typed pointers now
3200   o Removed API:
3201     HB_TAG_STR()
3204 * Use ISO 15924 tags for hb_script_t:
3206   o New API:
3207     hb_script_from_iso15924_tag()
3208     hb_script_to_iso15924_tag()
3209     hb_script_from_string()
3211   o Changed API:
3212     HB_SCRIPT_* enum members changed value.
3215 * Buffer API streamlined:
3217   o New API:
3218     hb_buffer_reset()
3219     hb_buffer_set_length()
3220     hb_buffer_allocation_successful()
3222   o Renamed API:
3223     hb_buffer_ensure() renamed to hb_buffer_pre_allocate()
3224     hb_buffer_add_glyph() renamed to hb_buffer_add()
3226   o Removed API:
3227     hb_buffer_clear()
3228     hb_buffer_clear_positions()
3230   o Changed API:
3231     hb_buffer_get_glyph_infos() takes an out length parameter now
3232     hb_buffer_get_glyph_positions() takes an out length parameter now
3235 * Blob API streamlined:
3237   o New API:
3238     hb_blob_get_data()
3239     hb_blob_get_data_writable()
3241   o Renamed API:
3242     hb_blob_create_empty() renamed to hb_blob_get_empty()
3244   o Removed API:
3245     hb_blob_lock()
3246     hb_blob_unlock()
3247     hb_blob_is_writable()
3248     hb_blob_try_writable()
3250   o Changed API:
3251     hb_blob_create() takes user_data before destroy now
3254 * Unicode functions API:
3256   o Unicode function vectors can subclass other unicode function vectors now.
3257     Unimplemented callbacks in the subclass automatically chainup to the parent.
3259   o All hb_unicode_funcs_t callbacks take a user_data now.  Their setters
3260     take a user_data and its respective destroy callback.
3262   o New API:
3263     hb_unicode_funcs_get_empty()
3264     hb_unicode_funcs_get_default()
3265     hb_unicode_funcs_get_parent()
3267   o Changed API:
3268     hb_unicode_funcs_create() now takes a parent_funcs.
3270   o Removed func getter functions:
3271     hb_unicode_funcs_get_mirroring_func()
3272     hb_unicode_funcs_get_general_category_func()
3273     hb_unicode_funcs_get_script_func()
3274     hb_unicode_funcs_get_combining_class_func()
3275     hb_unicode_funcs_get_eastasian_width_func()
3278 * Face API:
3280   o Renamed API:
3281     hb_face_get_table() renamed to hb_face_reference_table()
3282     hb_face_create_for_data() renamed to hb_face_create()
3284   o Changed API:
3285     hb_face_create_for_tables() takes user_data before destroy now
3286     hb_face_reference_table() returns empty blob instead of NULL
3287     hb_get_table_func_t accepts the face as first parameter now
3289 * Font API:
3291   o Fonts can subclass other fonts now.  Unimplemented callbacks in the
3292     subclass automatically chainup to the parent.  When chaining up,
3293     scale is adjusted if the parent font has a different scale.
3295   o All hb_font_funcs_t callbacks take a user_data now.  Their setters
3296     take a user_data and its respective destroy callback.
3298   o New API:
3299     hb_font_get_parent()
3300     hb_font_funcs_get_empty()
3301     hb_font_create_sub_font()
3303   o Removed API:
3304     hb_font_funcs_copy()
3305     hb_font_unset_funcs()
3307   o Removed func getter functions:
3308     hb_font_funcs_get_glyph_func()
3309     hb_font_funcs_get_glyph_advance_func()
3310     hb_font_funcs_get_glyph_extents_func()
3311     hb_font_funcs_get_contour_point_func()
3312     hb_font_funcs_get_kerning_func()
3314   o Changed API:
3315     hb_font_create() takes a face and references it now
3316     hb_font_set_funcs() takes user_data before destroy now
3317     hb_font_set_scale() accepts signed integers now
3318     hb_font_get_contour_point_func_t now takes glyph first, then point_index
3319     hb_font_get_glyph_func_t returns a success boolean now
3322 * Changed object model:
3324   o All object types have a _get_empty() now:
3325     hb_blob_get_empty()
3326     hb_buffer_get_empty()
3327     hb_face_get_empty()
3328     hb_font_get_empty()
3329     hb_font_funcs_get_empty()
3330     hb_unicode_funcs_get_empty()
3332   o Added _set_user_data() and _get_user_data() for all object types:
3333     hb_blob_get_user_data()
3334     hb_blob_set_user_data()
3335     hb_buffer_get_user_data()
3336     hb_buffer_set_user_data()
3337     hb_face_get_user_data()
3338     hb_face_set_user_data()
3339     hb_font_funcs_get_user_data()
3340     hb_font_funcs_set_user_data()
3341     hb_font_get_user_data()
3342     hb_font_set_user_data()
3343     hb_unicode_funcs_get_user_data()
3344     hb_unicode_funcs_set_user_data()
3346   o Removed the _get_reference_count() from all object types:
3347     hb_blob_get_reference_count()
3348     hb_buffer_get_reference_count()
3349     hb_face_get_reference_count()
3350     hb_font_funcs_get_reference_count()
3351     hb_font_get_reference_count()
3352     hb_unicode_funcs_get_reference_count()
3354   o Added _make_immutable() and _is_immutable() for all object types except for buffer:
3355     hb_blob_make_immutable()
3356     hb_blob_is_immutable()
3357     hb_face_make_immutable()
3358     hb_face_is_immutable()
3361 * Changed API for vertical text support
3363   o The following callbacks where removed:
3364     hb_font_get_glyph_advance_func_t
3365     hb_font_get_kerning_func_t
3367   o The following new callbacks added instead:
3368     hb_font_get_glyph_h_advance_func_t
3369     hb_font_get_glyph_v_advance_func_t
3370     hb_font_get_glyph_h_origin_func_t
3371     hb_font_get_glyph_v_origin_func_t
3372     hb_font_get_glyph_h_kerning_func_t
3373     hb_font_get_glyph_v_kerning_func_t
3375   o The following API removed as such:
3376     hb_font_funcs_set_glyph_advance_func()
3377     hb_font_funcs_set_kerning_func()
3378     hb_font_get_glyph_advance()
3379     hb_font_get_kerning()
3381   o New API added instead:
3382     hb_font_funcs_set_glyph_h_advance_func()
3383     hb_font_funcs_set_glyph_v_advance_func()
3384     hb_font_funcs_set_glyph_h_origin_func()
3385     hb_font_funcs_set_glyph_v_origin_func()
3386     hb_font_funcs_set_glyph_h_kerning_func()
3387     hb_font_funcs_set_glyph_v_kerning_func()
3388     hb_font_get_glyph_h_advance()
3389     hb_font_get_glyph_v_advance()
3390     hb_font_get_glyph_h_origin()
3391     hb_font_get_glyph_v_origin()
3392     hb_font_get_glyph_h_kerning()
3393     hb_font_get_glyph_v_kerning()
3395   o The following higher-leve API added for convenience:
3396     hb_font_get_glyph_advance_for_direction()
3397     hb_font_get_glyph_origin_for_direction()
3398     hb_font_add_glyph_origin_for_direction()
3399     hb_font_subtract_glyph_origin_for_direction()
3400     hb_font_get_glyph_kerning_for_direction()
3401     hb_font_get_glyph_extents_for_origin()
3402     hb_font_get_glyph_contour_point_for_origin()
3405 * OpenType Layout API:
3407   o New API:
3408     hb_ot_layout_position_start()
3409     hb_ot_layout_substitute_start()
3410     hb_ot_layout_substitute_finish()
3413 * Glue code:
3415   o New API:
3416     hb_glib_script_to_script()
3417     hb_glib_script_from_script()
3418     hb_icu_script_to_script()
3419     hb_icu_script_from_script()
3422 * Version API added:
3424   o New API:
3425     HB_VERSION_MAJOR
3426     HB_VERSION_MINOR
3427     HB_VERSION_MICRO
3428     HB_VERSION_STRING
3429     HB_VERSION_CHECK()
3430     hb_version()
3431     hb_version_string()
3432     hb_version_check()