diff options
| author | Matthias Clasen <mclasen@redhat.com> | 2021-02-22 00:26:52 -0500 |
|---|---|---|
| committer | Matthias Clasen <mclasen@redhat.com> | 2021-03-11 13:17:37 -0500 |
| commit | 7632435e937d2c921e6eb96d40cfde55bd3d9500 (patch) | |
| tree | 50fd5835bd513d784b199234c553d62e5b003d28 /pango/pangofc-font.c | |
| parent | 5ac7f03b8195d2d4d0c2893b1284029132a9af10 (diff) | |
| download | pango-7632435e937d2c921e6eb96d40cfde55bd3d9500.tar.gz | |
pangofc: Tweak docs
Convert link syntax and add summaries.
Diffstat (limited to 'pango/pangofc-font.c')
| -rw-r--r-- | pango/pangofc-font.c | 30 |
1 files changed, 11 insertions, 19 deletions
diff --git a/pango/pangofc-font.c b/pango/pangofc-font.c index d8616537..5a164343 100644 --- a/pango/pangofc-font.c +++ b/pango/pangofc-font.c @@ -19,19 +19,6 @@ * Boston, MA 02111-1307, USA. */ -/** - * SECTION:pangofc-font - * @short_description:Base font class for Fontconfig-based backends - * @title:PangoFcFont - * @see_also: #PangoFcFontMap - * - * `PangoFcFont` is a base class for font implementation using the - * Fontconfig and FreeType libraries. It is used in the Xft and - * FreeType backends shipped with Pango, but can also be used when - * creating new backends. Any backend deriving from this base class - * will take advantage of the wide range of shapers implemented using - * FreeType that come with Pango. - */ #include "config.h" #include "pangofc-font-private.h" @@ -542,7 +529,8 @@ pango_fc_font_real_get_glyph (PangoFcFont *font, * pango_fc_font_lock_face: (skip) * @font: a `PangoFcFont`. * - * Gets the FreeType `FT_Face` associated with a font, + * Gets the FreeType `FT_Face` associated with a font. + * * This face will be kept around until you call * [method@PangoFc.Font.unlock_face]. * @@ -613,8 +601,10 @@ pango_fc_font_has_char (PangoFcFont *font, * @wc: Unicode character to look up * * Gets the glyph index for a given Unicode character - * for @font. If you only want to determine whether the - * font has the glyph, use [method@PangoFc.Font.has_char]. + * for @font. + * + * If you only want to determine whether the font has + * the glyph, use [method@PangoFc.Font.has_char]. * * Return value: the glyph index, or 0, if the Unicode * character doesn't exist in the font. @@ -716,6 +706,7 @@ _pango_fc_font_get_decoder (PangoFcFont *font) * @decoder: a `PangoFcDecoder` to set for this font * * This sets a custom decoder for this font. + * * Any previous decoder will be released before this one is set. * * Since: 1.6 @@ -761,9 +752,10 @@ _pango_fc_font_set_font_key (PangoFcFont *fcfont, * @logical_rect: (out) (optional): location to store logical extents * of the glyph or %NULL * - * Gets the extents of a single glyph from a font. The extents are in - * user space; that is, they are not transformed by any matrix in effect - * for the font. + * Gets the extents of a single glyph from a font. + * + * The extents are in user space; that is, they are not transformed + * by any matrix in effect for the font. * * Long term, this functionality probably belongs in the default * implementation of the get_glyph_extents() virtual function. |