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