From 7f04ed9259fd91cdb3dc61c5aa43d196ec6a965f Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Wed, 19 May 2021 16:06:44 -0400 Subject: docs: Convert gtk-doc syntax leftovers Remove leftovers like #Type, reduce indentations to avoid markdown block quotes, etc. --- pango/fonts.c | 46 +++++++++++++++++++++++----------------------- 1 file changed, 23 insertions(+), 23 deletions(-) (limited to 'pango/fonts.c') diff --git a/pango/fonts.c b/pango/fonts.c index a0f67e7c..8f08698c 100644 --- a/pango/fonts.c +++ b/pango/fonts.c @@ -183,7 +183,7 @@ pango_font_description_get_family (const PangoFontDescription *desc) * * The [enum@Pango.Style] enumeration describes whether the font is * slanted and the manner in which it is slanted; it can be either - * #PANGO_STYLE_NORMAL, #PANGO_STYLE_ITALIC, or #PANGO_STYLE_OBLIQUE. + * %PANGO_STYLE_NORMAL, %PANGO_STYLE_ITALIC, or %PANGO_STYLE_OBLIQUE. * * Most fonts will either have a italic style or an oblique style, * but not both, and font matching in Pango will match italic @@ -1803,10 +1803,8 @@ pango_font_find_shaper (PangoFont *font, * pango_font_get_glyph_extents: * @font: (nullable): a `PangoFont` * @glyph: the glyph index - * @ink_rect: (out) (optional): rectangle used to store the extents of the glyph - * as drawn or %NULL to indicate that the result is not needed. - * @logical_rect: (out) (optional): rectangle used to store the logical extents of - * the glyph or %NULL to indicate that the result is not needed. + * @ink_rect: (out) (optional): rectangle used to store the extents of the glyph as drawn + * @logical_rect: (out) (optional): rectangle used to store the logical extents of the glyph * * Gets the logical and ink extents of a glyph within a font. * @@ -1893,21 +1891,22 @@ pango_font_get_metrics (PangoFont *font, /** * pango_font_get_font_map: - * @font: (nullable): a `PangoFont`, or %NULL + * @font: (nullable): a `PangoFont` * * Gets the font map for which the font was created. * - * Note that the font maintains a *weak* reference to the font map, so if - * all references to font map are dropped, the font map will be finalized - * even if there are fonts created with the font map that are still alive. + * Note that the font maintains a *weak* reference to + * the font map, so if all references to font map are + * dropped, the font map will be finalized even if there + * are fonts created with the font map that are still alive. * In that case this function will return %NULL. * - * It is the responsibility of the user to ensure that the font map is kept - * alive. In most uses this is not an issue as a #PangoContext holds - * a reference to the font map. + * It is the responsibility of the user to ensure that the + * font map is kept alive. In most uses this is not an issue + * as a `PangoContext` holds a reference to the font map. * - * Return value: (transfer none) (nullable): the `PangoFontMap` for the - * font, or %NULL if @font is %NULL. + * Return value: (transfer none) (nullable): the `PangoFontMap` + * for the font * * Since: 1.10 */ @@ -1947,11 +1946,12 @@ pango_font_get_face (PangoFont *font) * * Get a `hb_font_t` object backing this font. * - * Note that the objects returned by this function are cached and immutable. - * If you need to make changes to the `hb_font_t`, use hb_font_create_sub_font(). + * Note that the objects returned by this function are cached + * and immutable. If you need to make changes to the `hb_font_t`, + * use hb_font_create_sub_font(). * - * Returns: (transfer none) (nullable): the `hb_font_t` object backing the - * font, or %NULL if the font does not have one + * Returns: (transfer none) (nullable): the `hb_font_t` object + * backing the font * * Since: 1.44 */ @@ -2369,13 +2369,13 @@ pango_font_family_real_get_face (PangoFontFamily *family, * pango_font_family_get_face: * @family: a `PangoFontFamily` * @name: (nullable): the name of a face. If the name is %NULL, - * the family's default face (fontconfig calls it "Regular") - * will be returned. + * the family's default face (fontconfig calls it "Regular") + * will be returned. * * Gets the `PangoFontFace` of @family with the given name. * * Returns: (transfer none) (nullable): the `PangoFontFace`, - * or %NULL if no face with the given name exists. + * or %NULL if no face with the given name exists. * * Since: 1.46 */ @@ -2526,8 +2526,8 @@ pango_font_face_get_face_name (PangoFontFace *face) * pango_font_face_list_sizes: * @face: a `PangoFontFace`. * @sizes: (out) (array length=n_sizes) (nullable) (optional): - * location to store a pointer to an array of int. This array - * should be freed with g_free(). + * location to store a pointer to an array of int. This array + * should be freed with g_free(). * @n_sizes: location to store the number of elements in @sizes * * List the available sizes for a font. -- cgit v1.2.1