[doc] Use XSince for REPLACEME/EXPERIMENTAL

To hide them from gtk-doc so that we can finally enable gtkdoc-check.
This commit is contained in:
Khaled Hosny 2023-02-11 20:01:06 +02:00 committed by خالد حسني (Khaled Hosny)
parent 16dfd263b1
commit 0ea8bbd91a
16 changed files with 96 additions and 96 deletions

View File

@ -17,7 +17,7 @@
- [ ] Based on severity of changes, decide whether it's a minor or micro release number bump. - [ ] Based on severity of changes, decide whether it's a minor or micro release number bump.
- [ ] Search for REPLACEME on the repository and replace it with the chosen version for the release. - [ ] Search for 'XSince: REPLACEME' on the repository and replace it with the chosen version for the release, e.g. 'Since: 1.4.7'.
- [ ] Make sure you have correct date and new version at the top of NEWS file. - [ ] Make sure you have correct date and new version at the top of NEWS file.

View File

@ -651,7 +651,7 @@ user_font_face_create (hb_face_t *face)
* *
* Returns: (transfer full): a newly created #cairo_font_face_t * Returns: (transfer full): a newly created #cairo_font_face_t
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
cairo_font_face_t * cairo_font_face_t *
hb_cairo_font_face_create_for_font (hb_font_t *font) hb_cairo_font_face_create_for_font (hb_font_t *font)
@ -677,7 +677,7 @@ hb_cairo_font_face_create_for_font (hb_font_t *font)
* *
* Returns: (nullable) (transfer none): the #hb_font_t that @font_face was created from * Returns: (nullable) (transfer none): the #hb_font_t that @font_face was created from
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
hb_font_t * hb_font_t *
hb_cairo_font_face_get_font (cairo_font_face_t *font_face) hb_cairo_font_face_get_font (cairo_font_face_t *font_face)
@ -695,7 +695,7 @@ hb_cairo_font_face_get_font (cairo_font_face_t *font_face)
* *
* Returns: (transfer full): a newly created #cairo_font_face_t * Returns: (transfer full): a newly created #cairo_font_face_t
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
cairo_font_face_t * cairo_font_face_t *
hb_cairo_font_face_create_for_face (hb_face_t *face) hb_cairo_font_face_create_for_face (hb_face_t *face)
@ -713,7 +713,7 @@ hb_cairo_font_face_create_for_face (hb_face_t *face)
* *
* Returns: (nullable) (transfer none): the #hb_face_t associated with @font_face * Returns: (nullable) (transfer none): the #hb_face_t associated with @font_face
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
hb_face_t * hb_face_t *
hb_cairo_font_face_get_face (cairo_font_face_t *font_face) hb_cairo_font_face_get_face (cairo_font_face_t *font_face)
@ -733,7 +733,7 @@ hb_cairo_font_face_get_face (cairo_font_face_t *font_face)
* face created using hb_cairo_font_face_create_for_face() * face created using hb_cairo_font_face_create_for_face()
* creates an #hb_font_t for a #cairo_scaled_font_t. * creates an #hb_font_t for a #cairo_scaled_font_t.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_cairo_font_face_set_font_init_func (cairo_font_face_t *font_face, hb_cairo_font_face_set_font_init_func (cairo_font_face_t *font_face,
@ -766,7 +766,7 @@ hb_cairo_font_face_set_font_init_func (cairo_font_face_t *font_face,
* *
* Returns: (nullable) (transfer none): the #hb_font_t associated with @scaled_font * Returns: (nullable) (transfer none): the #hb_font_t associated with @scaled_font
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
hb_font_t * hb_font_t *
hb_cairo_scaled_font_get_font (cairo_scaled_font_t *scaled_font) hb_cairo_scaled_font_get_font (cairo_scaled_font_t *scaled_font)
@ -814,7 +814,7 @@ hb_cairo_scaled_font_get_font (cairo_scaled_font_t *scaled_font)
* (because you set the scale of the #hb_font_t yourself), use * (because you set the scale of the #hb_font_t yourself), use
* the conversion rate involved. * the conversion rate involved.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_cairo_font_face_set_scale_factor (cairo_font_face_t *font_face, hb_cairo_font_face_set_scale_factor (cairo_font_face_t *font_face,
@ -835,7 +835,7 @@ hb_cairo_font_face_set_scale_factor (cairo_font_face_t *font_face,
* *
* Returns: the scale factor of @font_face * Returns: the scale factor of @font_face
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
unsigned int unsigned int
hb_cairo_font_face_get_scale_factor (cairo_font_face_t *font_face) hb_cairo_font_face_get_scale_factor (cairo_font_face_t *font_face)
@ -898,7 +898,7 @@ hb_cairo_font_face_get_scale_factor (cairo_font_face_t *font_face)
* it and the x,y values of the extra entry at the end add up the advance * it and the x,y values of the extra entry at the end add up the advance
* x,y of all the glyphs in the @buffer. * x,y of all the glyphs in the @buffer.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_cairo_glyphs_from_buffer (hb_buffer_t *buffer, hb_cairo_glyphs_from_buffer (hb_buffer_t *buffer,

View File

@ -57,7 +57,7 @@ hb_cairo_font_face_get_face (cairo_font_face_t *font_face);
* *
* Return value: the #hb_font_t value to use; in most cases same as @font * Return value: the #hb_font_t value to use; in most cases same as @font
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef hb_font_t * (*hb_cairo_font_init_func_t) (hb_font_t *font, typedef hb_font_t * (*hb_cairo_font_init_func_t) (hb_font_t *font,
cairo_scaled_font_t *scaled_font, cairo_scaled_font_t *scaled_font,

View File

@ -207,7 +207,7 @@ DEFINE_NULL_INSTANCE (hb_draw_funcs_t) =
* *
* Return value: (transfer full): The empty draw-functions structure * Return value: (transfer full): The empty draw-functions structure
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
hb_draw_funcs_t * hb_draw_funcs_t *
hb_draw_funcs_get_empty () hb_draw_funcs_get_empty ()
@ -276,7 +276,7 @@ hb_draw_funcs_destroy (hb_draw_funcs_t *dfuncs)
* *
* Return value: `true` if success, `false` otherwise * Return value: `true` if success, `false` otherwise
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
hb_bool_t hb_bool_t
hb_draw_funcs_set_user_data (hb_draw_funcs_t *dfuncs, hb_draw_funcs_set_user_data (hb_draw_funcs_t *dfuncs,
@ -298,7 +298,7 @@ hb_draw_funcs_set_user_data (hb_draw_funcs_t *dfuncs,
* *
* Return value: (transfer none): A pointer to the user data * Return value: (transfer none): A pointer to the user data
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
void * void *
hb_draw_funcs_get_user_data (const hb_draw_funcs_t *dfuncs, hb_draw_funcs_get_user_data (const hb_draw_funcs_t *dfuncs,

View File

@ -609,7 +609,7 @@ hb_face_collect_unicodes (hb_face_t *face,
* Collects the mapping from Unicode characters to nominal glyphs of the @face, * Collects the mapping from Unicode characters to nominal glyphs of the @face,
* and optionally all of the Unicode characters covered by @face. * and optionally all of the Unicode characters covered by @face.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_face_collect_nominal_glyph_mapping (hb_face_t *face, hb_face_collect_nominal_glyph_mapping (hb_face_t *face,

View File

@ -1417,7 +1417,7 @@ hb_font_get_glyph_shape (hb_font_t *font,
* The outline is returned by way of calls to the callbacks of the @dfuncs * The outline is returned by way of calls to the callbacks of the @dfuncs
* objects, with @draw_data passed to them. * objects, with @draw_data passed to them.
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
void void
hb_font_draw_glyph (hb_font_t *font, hb_font_draw_glyph (hb_font_t *font,
@ -1446,7 +1446,7 @@ hb_font_draw_glyph (hb_font_t *font,
* then @palette_index selects the palette to use. If the font only * then @palette_index selects the palette to use. If the font only
* has one palette, this will be 0. * has one palette, this will be 0.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_font_paint_glyph (hb_font_t *font, hb_font_paint_glyph (hb_font_t *font,
@ -2475,7 +2475,7 @@ hb_font_get_ptem (hb_font_t *font)
* useful for simulating [font grading](https://fonts.google.com/knowledge/glossary/grade). * useful for simulating [font grading](https://fonts.google.com/knowledge/glossary/grade).
* *
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
void void
hb_font_set_synthetic_bold (hb_font_t *font, hb_font_set_synthetic_bold (hb_font_t *font,
@ -2508,7 +2508,7 @@ hb_font_set_synthetic_bold (hb_font_t *font,
* *
* Fetches the "synthetic boldness" parameters of a font. * Fetches the "synthetic boldness" parameters of a font.
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
void void
hb_font_get_synthetic_bold (hb_font_t *font, hb_font_get_synthetic_bold (hb_font_t *font,
@ -2723,7 +2723,7 @@ hb_font_set_var_named_instance (hb_font_t *font,
* *
* Return value: Named-instance index or %HB_FONT_NO_VAR_NAMED_INSTANCE. * Return value: Named-instance index or %HB_FONT_NO_VAR_NAMED_INSTANCE.
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
unsigned int unsigned int
hb_font_get_var_named_instance (hb_font_t *font) hb_font_get_var_named_instance (hb_font_t *font)

View File

@ -516,7 +516,7 @@ typedef void (*hb_font_get_glyph_shape_func_t) (hb_font_t *font, void *font_data
* *
* A virtual method for the #hb_font_funcs_t of an #hb_font_t object. * A virtual method for the #hb_font_funcs_t of an #hb_font_t object.
* *
* Since: REPLACEME * XSince: REPLACEME
* *
**/ **/
typedef void (*hb_font_draw_glyph_func_t) (hb_font_t *font, void *font_data, typedef void (*hb_font_draw_glyph_func_t) (hb_font_t *font, void *font_data,
@ -537,7 +537,7 @@ typedef void (*hb_font_draw_glyph_func_t) (hb_font_t *font, void *font_data,
* *
* A virtual method for the #hb_font_funcs_t of an #hb_font_t object. * A virtual method for the #hb_font_funcs_t of an #hb_font_t object.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_font_paint_glyph_func_t) (hb_font_t *font, void *font_data, typedef void (*hb_font_paint_glyph_func_t) (hb_font_t *font, void *font_data,
hb_codepoint_t glyph, hb_codepoint_t glyph,
@ -833,7 +833,7 @@ hb_font_funcs_set_glyph_shape_func (hb_font_funcs_t *ffuncs,
* Sets the implementation function for #hb_font_draw_glyph_func_t, * Sets the implementation function for #hb_font_draw_glyph_func_t,
* which is the same as #hb_font_get_glyph_shape_func_t. * which is the same as #hb_font_get_glyph_shape_func_t.
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
HB_EXTERN void HB_EXTERN void
hb_font_funcs_set_draw_glyph_func (hb_font_funcs_t *ffuncs, hb_font_funcs_set_draw_glyph_func (hb_font_funcs_t *ffuncs,
@ -849,7 +849,7 @@ hb_font_funcs_set_draw_glyph_func (hb_font_funcs_t *ffuncs,
* *
* Sets the implementation function for #hb_font_paint_glyph_func_t. * Sets the implementation function for #hb_font_paint_glyph_func_t.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_font_funcs_set_paint_glyph_func (hb_font_funcs_t *ffuncs, hb_font_funcs_set_paint_glyph_func (hb_font_funcs_t *ffuncs,
@ -1177,7 +1177,7 @@ hb_font_get_var_coords_normalized (hb_font_t *font,
* named-instance index set. This is the default of * named-instance index set. This is the default of
* a font. * a font.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
#define HB_FONT_NO_VAR_NAMED_INSTANCE 0xFFFFFFFF #define HB_FONT_NO_VAR_NAMED_INSTANCE 0xFFFFFFFF

View File

@ -349,7 +349,7 @@ hb_map_hash (const hb_map_t *map)
* *
* Add the contents of @other to @map. * Add the contents of @other to @map.
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
HB_EXTERN void HB_EXTERN void
hb_map_update (hb_map_t *map, hb_map_update (hb_map_t *map,
@ -375,7 +375,7 @@ hb_map_update (hb_map_t *map,
* *
* Return value: `true` if there was a next value, `false` otherwise * Return value: `true` if there was a next value, `false` otherwise
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
hb_bool_t hb_bool_t
hb_map_next (const hb_map_t *map, hb_map_next (const hb_map_t *map,
@ -393,7 +393,7 @@ hb_map_next (const hb_map_t *map,
* *
* Add the keys of @map to @keys. * Add the keys of @map to @keys.
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
void void
hb_map_keys (const hb_map_t *map, hb_map_keys (const hb_map_t *map,
@ -409,7 +409,7 @@ hb_map_keys (const hb_map_t *map,
* *
* Add the values of @map to @values. * Add the values of @map to @values.
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
void void
hb_map_values (const hb_map_t *map, hb_map_values (const hb_map_t *map,

View File

@ -216,7 +216,7 @@ hb_ot_color_has_layers (hb_face_t *face)
* *
* Return value: `true` if data found, `false` otherwise * Return value: `true` if data found, `false` otherwise
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
hb_bool_t hb_bool_t
hb_ot_color_has_paint (hb_face_t *face) hb_ot_color_has_paint (hb_face_t *face)
@ -234,7 +234,7 @@ hb_ot_color_has_paint (hb_face_t *face)
* *
* Return value: `true` if data found, `false` otherwise * Return value: `true` if data found, `false` otherwise
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
hb_bool_t hb_bool_t
hb_ot_color_glyph_has_paint (hb_face_t *face, hb_ot_color_glyph_has_paint (hb_face_t *face,

View File

@ -746,7 +746,7 @@ hb_ot_layout_script_find_language (hb_face_t *face,
* *
* Return value: `true` if one of the given language tags is found, `false` otherwise * Return value: `true` if one of the given language tags is found, `false` otherwise
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
hb_bool_t hb_bool_t
hb_ot_layout_script_select_language2 (hb_face_t *face, hb_ot_layout_script_select_language2 (hb_face_t *face,

View File

@ -69,7 +69,7 @@ HB_BEGIN_DECLS
* For more information on these fields, see the * For more information on these fields, see the
* [OpenType spec](https://docs.microsoft.com/en-us/typography/opentype/spec/name#name-ids). * [OpenType spec](https://docs.microsoft.com/en-us/typography/opentype/spec/name#name-ids).
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
typedef enum typedef enum
{ {

View File

@ -216,7 +216,7 @@ HB_PAINT_FUNCS_IMPLEMENT_CALLBACKS
* *
* Returns value: (transfer full): the paint-functions structure * Returns value: (transfer full): the paint-functions structure
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
hb_paint_funcs_t * hb_paint_funcs_t *
hb_paint_funcs_create () hb_paint_funcs_create ()
@ -248,7 +248,7 @@ DEFINE_NULL_INSTANCE (hb_paint_funcs_t) =
* *
* Return value: (transfer full): The empty paint-functions structure * Return value: (transfer full): The empty paint-functions structure
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
hb_paint_funcs_t * hb_paint_funcs_t *
hb_paint_funcs_get_empty () hb_paint_funcs_get_empty ()
@ -267,7 +267,7 @@ hb_paint_funcs_get_empty ()
* *
* Return value: The paint-functions structure * Return value: The paint-functions structure
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
hb_paint_funcs_t * hb_paint_funcs_t *
hb_paint_funcs_reference (hb_paint_funcs_t *funcs) hb_paint_funcs_reference (hb_paint_funcs_t *funcs)
@ -284,7 +284,7 @@ hb_paint_funcs_reference (hb_paint_funcs_t *funcs)
* When the reference count reaches zero, the structure * When the reference count reaches zero, the structure
* is destroyed, freeing all memory. * is destroyed, freeing all memory.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_funcs_destroy (hb_paint_funcs_t *funcs) hb_paint_funcs_destroy (hb_paint_funcs_t *funcs)
@ -316,7 +316,7 @@ hb_paint_funcs_destroy (hb_paint_funcs_t *funcs)
* *
* Return value: `true` if success, `false` otherwise * Return value: `true` if success, `false` otherwise
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
hb_bool_t hb_bool_t
hb_paint_funcs_set_user_data (hb_paint_funcs_t *funcs, hb_paint_funcs_set_user_data (hb_paint_funcs_t *funcs,
@ -338,7 +338,7 @@ hb_paint_funcs_set_user_data (hb_paint_funcs_t *funcs,
* *
* Return value: (transfer none): A pointer to the user data * Return value: (transfer none): A pointer to the user data
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
void * void *
hb_paint_funcs_get_user_data (const hb_paint_funcs_t *funcs, hb_paint_funcs_get_user_data (const hb_paint_funcs_t *funcs,
@ -356,7 +356,7 @@ hb_paint_funcs_get_user_data (const hb_paint_funcs_t *funcs,
* After this call, all attempts to set one of the callbacks * After this call, all attempts to set one of the callbacks
* on @funcs will fail. * on @funcs will fail.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_funcs_make_immutable (hb_paint_funcs_t *funcs) hb_paint_funcs_make_immutable (hb_paint_funcs_t *funcs)
@ -375,7 +375,7 @@ hb_paint_funcs_make_immutable (hb_paint_funcs_t *funcs)
* *
* Return value: `true` if @funcs is immutable, `false` otherwise * Return value: `true` if @funcs is immutable, `false` otherwise
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
hb_bool_t hb_bool_t
hb_paint_funcs_is_immutable (hb_paint_funcs_t *funcs) hb_paint_funcs_is_immutable (hb_paint_funcs_t *funcs)
@ -400,7 +400,7 @@ hb_paint_funcs_is_immutable (hb_paint_funcs_t *funcs)
* *
* Return value: the total number of color stops in @color_line * Return value: the total number of color stops in @color_line
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
unsigned int unsigned int
hb_color_line_get_color_stops (hb_color_line_t *color_line, hb_color_line_get_color_stops (hb_color_line_t *color_line,
@ -423,7 +423,7 @@ hb_color_line_get_color_stops (hb_color_line_t *color_line,
* *
* Return value: the extend mode of @color_line * Return value: the extend mode of @color_line
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
hb_paint_extend_t hb_paint_extend_t
hb_color_line_get_extend (hb_color_line_t *color_line) hb_color_line_get_extend (hb_color_line_t *color_line)
@ -447,7 +447,7 @@ hb_color_line_get_extend (hb_color_line_t *color_line)
* *
* Perform a "push-transform" paint operation. * Perform a "push-transform" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_push_transform (hb_paint_funcs_t *funcs, void *paint_data, hb_paint_push_transform (hb_paint_funcs_t *funcs, void *paint_data,
@ -465,7 +465,7 @@ hb_paint_push_transform (hb_paint_funcs_t *funcs, void *paint_data,
* *
* Perform a "pop-transform" paint operation. * Perform a "pop-transform" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_pop_transform (hb_paint_funcs_t *funcs, void *paint_data) hb_paint_pop_transform (hb_paint_funcs_t *funcs, void *paint_data)
@ -482,7 +482,7 @@ hb_paint_pop_transform (hb_paint_funcs_t *funcs, void *paint_data)
* *
* Perform a "push-clip-glyph" paint operation. * Perform a "push-clip-glyph" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_push_clip_glyph (hb_paint_funcs_t *funcs, void *paint_data, hb_paint_push_clip_glyph (hb_paint_funcs_t *funcs, void *paint_data,
@ -503,7 +503,7 @@ hb_paint_push_clip_glyph (hb_paint_funcs_t *funcs, void *paint_data,
* *
* Perform a "push-clip-rect" paint operation. * Perform a "push-clip-rect" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_push_clip_rectangle (hb_paint_funcs_t *funcs, void *paint_data, hb_paint_push_clip_rectangle (hb_paint_funcs_t *funcs, void *paint_data,
@ -519,7 +519,7 @@ hb_paint_push_clip_rectangle (hb_paint_funcs_t *funcs, void *paint_data,
* *
* Perform a "pop-clip" paint operation. * Perform a "pop-clip" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_pop_clip (hb_paint_funcs_t *funcs, void *paint_data) hb_paint_pop_clip (hb_paint_funcs_t *funcs, void *paint_data)
@ -536,7 +536,7 @@ hb_paint_pop_clip (hb_paint_funcs_t *funcs, void *paint_data)
* *
* Perform a "color" paint operation. * Perform a "color" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_color (hb_paint_funcs_t *funcs, void *paint_data, hb_paint_color (hb_paint_funcs_t *funcs, void *paint_data,
@ -559,7 +559,7 @@ hb_paint_color (hb_paint_funcs_t *funcs, void *paint_data,
* *
* Perform a "image" paint operation. * Perform a "image" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_image (hb_paint_funcs_t *funcs, void *paint_data, hb_paint_image (hb_paint_funcs_t *funcs, void *paint_data,
@ -587,7 +587,7 @@ hb_paint_image (hb_paint_funcs_t *funcs, void *paint_data,
* *
* Perform a "linear-gradient" paint operation. * Perform a "linear-gradient" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_linear_gradient (hb_paint_funcs_t *funcs, void *paint_data, hb_paint_linear_gradient (hb_paint_funcs_t *funcs, void *paint_data,
@ -613,7 +613,7 @@ hb_paint_linear_gradient (hb_paint_funcs_t *funcs, void *paint_data,
* *
* Perform a "radial-gradient" paint operation. * Perform a "radial-gradient" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_radial_gradient (hb_paint_funcs_t *funcs, void *paint_data, hb_paint_radial_gradient (hb_paint_funcs_t *funcs, void *paint_data,
@ -636,7 +636,7 @@ hb_paint_radial_gradient (hb_paint_funcs_t *funcs, void *paint_data,
* *
* Perform a "sweep-gradient" paint operation. * Perform a "sweep-gradient" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_sweep_gradient (hb_paint_funcs_t *funcs, void *paint_data, hb_paint_sweep_gradient (hb_paint_funcs_t *funcs, void *paint_data,
@ -654,7 +654,7 @@ hb_paint_sweep_gradient (hb_paint_funcs_t *funcs, void *paint_data,
* *
* Perform a "push-group" paint operation. * Perform a "push-group" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_push_group (hb_paint_funcs_t *funcs, void *paint_data) hb_paint_push_group (hb_paint_funcs_t *funcs, void *paint_data)
@ -670,7 +670,7 @@ hb_paint_push_group (hb_paint_funcs_t *funcs, void *paint_data)
* *
* Perform a "pop-group" paint operation. * Perform a "pop-group" paint operation.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_paint_pop_group (hb_paint_funcs_t *funcs, void *paint_data, hb_paint_pop_group (hb_paint_funcs_t *funcs, void *paint_data,
@ -690,7 +690,7 @@ hb_paint_pop_group (hb_paint_funcs_t *funcs, void *paint_data,
* *
* Return value: `true` if found, `false` otherwise * Return value: `true` if found, `false` otherwise
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
hb_bool_t hb_bool_t
hb_paint_custom_palette_color (hb_paint_funcs_t *funcs, void *paint_data, hb_paint_custom_palette_color (hb_paint_funcs_t *funcs, void *paint_data,

View File

@ -58,7 +58,7 @@ HB_BEGIN_DECLS
* you want to override colors from the font palette with * you want to override colors from the font palette with
* custom colors. * custom colors.
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
typedef struct hb_paint_funcs_t hb_paint_funcs_t; typedef struct hb_paint_funcs_t hb_paint_funcs_t;
@ -111,7 +111,7 @@ hb_paint_funcs_is_immutable (hb_paint_funcs_t *funcs);
* and remains in effect until a matching call to * and remains in effect until a matching call to
* the #hb_paint_funcs_pop_transform_func_t vfunc. * the #hb_paint_funcs_pop_transform_func_t vfunc.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_push_transform_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_push_transform_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -130,7 +130,7 @@ typedef void (*hb_paint_push_transform_func_t) (hb_paint_funcs_t *funcs,
* the effect of a prior call to the #hb_paint_funcs_push_transform_func_t * the effect of a prior call to the #hb_paint_funcs_push_transform_func_t
* vfunc. * vfunc.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_pop_transform_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_pop_transform_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -154,7 +154,7 @@ typedef void (*hb_paint_pop_transform_func_t) (hb_paint_funcs_t *funcs,
* and remains in effect until a matching call to * and remains in effect until a matching call to
* the #hb_paint_funcs_pop_clip_func_t vfunc. * the #hb_paint_funcs_pop_clip_func_t vfunc.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_push_clip_glyph_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_push_clip_glyph_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -182,7 +182,7 @@ typedef void (*hb_paint_push_clip_glyph_func_t) (hb_paint_funcs_t *funcs,
* and remains in effect until a matching call to * and remains in effect until a matching call to
* the #hb_paint_funcs_pop_clip_func_t vfunc. * the #hb_paint_funcs_pop_clip_func_t vfunc.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_push_clip_rectangle_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_push_clip_rectangle_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -200,7 +200,7 @@ typedef void (*hb_paint_push_clip_rectangle_func_t) (hb_paint_funcs_t *funcs,
* the effect of a prior call to the #hb_paint_funcs_push_clip_glyph_func_t * the effect of a prior call to the #hb_paint_funcs_push_clip_glyph_func_t
* or #hb_paint_funcs_push_clip_rectangle_func_t vfuncs. * or #hb_paint_funcs_push_clip_rectangle_func_t vfuncs.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_pop_clip_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_pop_clip_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -217,7 +217,7 @@ typedef void (*hb_paint_pop_clip_func_t) (hb_paint_funcs_t *funcs,
* A virtual method for the #hb_paint_funcs_t to paint a * A virtual method for the #hb_paint_funcs_t to paint a
* color everywhere within the current clip. * color everywhere within the current clip.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_color_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_color_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -230,7 +230,7 @@ typedef void (*hb_paint_color_func_t) (hb_paint_funcs_t *funcs,
* *
* Tag identifying PNG images in #hb_paint_image_func_t callbacks. * Tag identifying PNG images in #hb_paint_image_func_t callbacks.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
#define HB_PAINT_IMAGE_FORMAT_PNG HB_TAG('p','n','g',' ') #define HB_PAINT_IMAGE_FORMAT_PNG HB_TAG('p','n','g',' ')
@ -239,7 +239,7 @@ typedef void (*hb_paint_color_func_t) (hb_paint_funcs_t *funcs,
* *
* Tag identifying SVG images in #hb_paint_image_func_t callbacks. * Tag identifying SVG images in #hb_paint_image_func_t callbacks.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
#define HB_PAINT_IMAGE_FORMAT_SVG HB_TAG('s','v','g',' ') #define HB_PAINT_IMAGE_FORMAT_SVG HB_TAG('s','v','g',' ')
@ -249,7 +249,7 @@ typedef void (*hb_paint_color_func_t) (hb_paint_funcs_t *funcs,
* Tag identifying raw pixel-data images in #hb_paint_image_func_t callbacks. * Tag identifying raw pixel-data images in #hb_paint_image_func_t callbacks.
* The data is in BGRA pre-multiplied sRGBA color-space format. * The data is in BGRA pre-multiplied sRGBA color-space format.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
#define HB_PAINT_IMAGE_FORMAT_BGRA HB_TAG('B','G','R','A') #define HB_PAINT_IMAGE_FORMAT_BGRA HB_TAG('B','G','R','A')
@ -277,7 +277,7 @@ typedef void (*hb_paint_color_func_t) (hb_paint_funcs_t *funcs,
* *
* Return value: Whether the operation was successful. * Return value: Whether the operation was successful.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef hb_bool_t (*hb_paint_image_func_t) (hb_paint_funcs_t *funcs, typedef hb_bool_t (*hb_paint_image_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -305,7 +305,7 @@ typedef hb_bool_t (*hb_paint_image_func_t) (hb_paint_funcs_t *funcs,
* [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr) * [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr)
* section for details. * section for details.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef struct { typedef struct {
float offset; float offset;
@ -331,7 +331,7 @@ typedef struct {
* See the OpenType spec [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr) * See the OpenType spec [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr)
* section for details. * section for details.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef enum { typedef enum {
HB_PAINT_EXTEND_PAD, HB_PAINT_EXTEND_PAD,
@ -355,7 +355,7 @@ typedef struct hb_color_line_t hb_color_line_t;
* *
* Return value: the total number of color stops in @color_line * Return value: the total number of color stops in @color_line
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef unsigned int (*hb_color_line_get_color_stops_func_t) (hb_color_line_t *color_line, typedef unsigned int (*hb_color_line_get_color_stops_func_t) (hb_color_line_t *color_line,
void *color_line_data, void *color_line_data,
@ -374,7 +374,7 @@ typedef unsigned int (*hb_color_line_get_color_stops_func_t) (hb_color_line_t *c
* *
* Return value: the extend mode of @color_line * Return value: the extend mode of @color_line
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef hb_paint_extend_t (*hb_color_line_get_extend_func_t) (hb_color_line_t *color_line, typedef hb_paint_extend_t (*hb_color_line_get_extend_func_t) (hb_color_line_t *color_line,
void *color_line_data, void *color_line_data,
@ -385,7 +385,7 @@ typedef hb_paint_extend_t (*hb_color_line_get_extend_func_t) (hb_color_line_t *c
* *
* A struct containing color information for a gradient. * A struct containing color information for a gradient.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
struct hb_color_line_t { struct hb_color_line_t {
void *data; void *data;
@ -441,7 +441,7 @@ hb_color_line_get_extend (hb_color_line_t *color_line);
* section for details on how the points define the direction * section for details on how the points define the direction
* of the gradient, and how to interpret the @color_line. * of the gradient, and how to interpret the @color_line.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_linear_gradient_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_linear_gradient_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -477,7 +477,7 @@ typedef void (*hb_paint_linear_gradient_func_t) (hb_paint_funcs_t *funcs,
* section for details on how the points define the direction * section for details on how the points define the direction
* of the gradient, and how to interpret the @color_line. * of the gradient, and how to interpret the @color_line.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_radial_gradient_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_radial_gradient_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -510,7 +510,7 @@ typedef void (*hb_paint_radial_gradient_func_t) (hb_paint_funcs_t *funcs,
* section for details on how the points define the direction * section for details on how the points define the direction
* of the gradient, and how to interpret the @color_line. * of the gradient, and how to interpret the @color_line.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_sweep_gradient_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_sweep_gradient_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -586,7 +586,7 @@ typedef void (*hb_paint_sweep_gradient_func_t) (hb_paint_funcs_t *funcs,
* See the OpenType spec [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr) * See the OpenType spec [COLR](https://learn.microsoft.com/en-us/typography/opentype/spec/colr)
* section for details. * section for details.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef enum { typedef enum {
HB_PAINT_COMPOSITE_MODE_CLEAR, HB_PAINT_COMPOSITE_MODE_CLEAR,
@ -632,7 +632,7 @@ typedef enum {
* until a matching call to the #hb_paint_funcs_pop_group_func_t * until a matching call to the #hb_paint_funcs_pop_group_func_t
* vfunc. * vfunc.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_push_group_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_push_group_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -653,7 +653,7 @@ typedef void (*hb_paint_push_group_func_t) (hb_paint_funcs_t *funcs,
* and then composites it on the previous surface, using the * and then composites it on the previous surface, using the
* compositing mode passed to this call. * compositing mode passed to this call.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef void (*hb_paint_pop_group_func_t) (hb_paint_funcs_t *funcs, typedef void (*hb_paint_pop_group_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -680,7 +680,7 @@ typedef void (*hb_paint_pop_group_func_t) (hb_paint_funcs_t *funcs,
* *
* Return value: `true` if found, `false` otherwise * Return value: `true` if found, `false` otherwise
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
typedef hb_bool_t (*hb_paint_custom_palette_color_func_t) (hb_paint_funcs_t *funcs, typedef hb_bool_t (*hb_paint_custom_palette_color_func_t) (hb_paint_funcs_t *funcs,
void *paint_data, void *paint_data,
@ -698,7 +698,7 @@ typedef hb_bool_t (*hb_paint_custom_palette_color_func_t) (hb_paint_funcs_t *fun
* *
* Sets the push-transform callback on the paint functions struct. * Sets the push-transform callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_push_transform_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_push_transform_func (hb_paint_funcs_t *funcs,
@ -715,7 +715,7 @@ hb_paint_funcs_set_push_transform_func (hb_paint_funcs_t *funcs,
* *
* Sets the pop-transform callback on the paint functions struct. * Sets the pop-transform callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_pop_transform_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_pop_transform_func (hb_paint_funcs_t *funcs,
@ -732,7 +732,7 @@ hb_paint_funcs_set_pop_transform_func (hb_paint_funcs_t *funcs,
* *
* Sets the push-clip-glyph callback on the paint functions struct. * Sets the push-clip-glyph callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_push_clip_glyph_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_push_clip_glyph_func (hb_paint_funcs_t *funcs,
@ -749,7 +749,7 @@ hb_paint_funcs_set_push_clip_glyph_func (hb_paint_funcs_t *funcs,
* *
* Sets the push-clip-rect callback on the paint functions struct. * Sets the push-clip-rect callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_push_clip_rectangle_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_push_clip_rectangle_func (hb_paint_funcs_t *funcs,
@ -766,7 +766,7 @@ hb_paint_funcs_set_push_clip_rectangle_func (hb_paint_funcs_t
* *
* Sets the pop-clip callback on the paint functions struct. * Sets the pop-clip callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_pop_clip_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_pop_clip_func (hb_paint_funcs_t *funcs,
@ -783,7 +783,7 @@ hb_paint_funcs_set_pop_clip_func (hb_paint_funcs_t *funcs,
* *
* Sets the paint-color callback on the paint functions struct. * Sets the paint-color callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_color_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_color_func (hb_paint_funcs_t *funcs,
@ -800,7 +800,7 @@ hb_paint_funcs_set_color_func (hb_paint_funcs_t *funcs,
* *
* Sets the paint-image callback on the paint functions struct. * Sets the paint-image callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_image_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_image_func (hb_paint_funcs_t *funcs,
@ -817,7 +817,7 @@ hb_paint_funcs_set_image_func (hb_paint_funcs_t *funcs,
* *
* Sets the linear-gradient callback on the paint functions struct. * Sets the linear-gradient callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_linear_gradient_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_linear_gradient_func (hb_paint_funcs_t *funcs,
@ -834,7 +834,7 @@ hb_paint_funcs_set_linear_gradient_func (hb_paint_funcs_t *funcs,
* *
* Sets the radial-gradient callback on the paint functions struct. * Sets the radial-gradient callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_radial_gradient_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_radial_gradient_func (hb_paint_funcs_t *funcs,
@ -851,7 +851,7 @@ hb_paint_funcs_set_radial_gradient_func (hb_paint_funcs_t *funcs,
* *
* Sets the sweep-gradient callback on the paint functions struct. * Sets the sweep-gradient callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_sweep_gradient_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_sweep_gradient_func (hb_paint_funcs_t *funcs,
@ -868,7 +868,7 @@ hb_paint_funcs_set_sweep_gradient_func (hb_paint_funcs_t *funcs,
* *
* Sets the push-group callback on the paint functions struct. * Sets the push-group callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_push_group_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_push_group_func (hb_paint_funcs_t *funcs,
@ -885,7 +885,7 @@ hb_paint_funcs_set_push_group_func (hb_paint_funcs_t *funcs,
* *
* Sets the pop-group callback on the paint functions struct. * Sets the pop-group callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_pop_group_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_pop_group_func (hb_paint_funcs_t *funcs,
@ -902,7 +902,7 @@ hb_paint_funcs_set_pop_group_func (hb_paint_funcs_t *funcs,
* *
* Sets the custom-palette-color callback on the paint functions struct. * Sets the custom-palette-color callback on the paint functions struct.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
HB_EXTERN void HB_EXTERN void
hb_paint_funcs_set_custom_palette_color_func (hb_paint_funcs_t *funcs, hb_paint_funcs_set_custom_palette_color_func (hb_paint_funcs_t *funcs,

View File

@ -501,7 +501,7 @@ hb_set_invert (hb_set_t *set)
* *
* Return value: `true` if the set is inverted, `false` otherwise * Return value: `true` if the set is inverted, `false` otherwise
* *
* Since: REPLACEME * XSince: REPLACEME
**/ **/
hb_bool_t hb_bool_t
hb_set_is_inverted (const hb_set_t *set) hb_set_is_inverted (const hb_set_t *set)

View File

@ -385,7 +385,7 @@ hb_subset_input_get_user_data (const hb_subset_input_t *input,
* *
* The input can be tailored afterwards by the caller. * The input can be tailored afterwards by the caller.
* *
* Since: REPLACEME * XSince: REPLACEME
*/ */
void void
hb_subset_input_keep_everything (hb_subset_input_t *input) hb_subset_input_keep_everything (hb_subset_input_t *input)
@ -539,7 +539,7 @@ hb_subset_preprocess (hb_face_t *source)
* Note: for mac platform, we only support name_str with all ascii characters, * Note: for mac platform, we only support name_str with all ascii characters,
* name_str with non-ascii characters will be ignored. * name_str with non-ascii characters will be ignored.
* *
* Since: EXPERIMENTAL * XSince: EXPERIMENTAL
**/ **/
HB_EXTERN hb_bool_t HB_EXTERN hb_bool_t
hb_subset_input_override_name_table (hb_subset_input_t *input, hb_subset_input_override_name_table (hb_subset_input_t *input,

View File

@ -38,7 +38,7 @@
* Table specific optimizations (eg. extension promotion in GSUB/GPOS) may be performed. * Table specific optimizations (eg. extension promotion in GSUB/GPOS) may be performed.
* Passing HB_TAG_NONE will disable table specific optimizations. * Passing HB_TAG_NONE will disable table specific optimizations.
* *
* Since: EXPERIMENTAL * XSince: EXPERIMENTAL
**/ **/
hb_blob_t* hb_subset_repack_or_fail (hb_tag_t table_tag, hb_blob_t* hb_subset_repack_or_fail (hb_tag_t table_tag,
hb_object_t* hb_objects, hb_object_t* hb_objects,