summaryrefslogtreecommitdiff
path: root/pango/pangoft2.c
diff options
context:
space:
mode:
authorBehdad Esfahbod <behdad@gnome.org>2006-02-05 03:11:58 +0000
committerBehdad Esfahbod <behdad@src.gnome.org>2006-02-05 03:11:58 +0000
commit6cddbd51fe9e616847a17be379149822c88104bf (patch)
tree1bcecc7d9210c334829b439ef515585ebe297624 /pango/pangoft2.c
parent8adcead819b6bb6781f0b01c6b17175b2918af8f (diff)
downloadpango-6cddbd51fe9e616847a17be379149822c88104bf.tar.gz
Change PANGO_GLYPH_EMPTY to 0x0FFFFFFF, to not overlap with
2006-02-04 Behdad Esfahbod <behdad@gnome.org> * pango/pango-types.h: Change PANGO_GLYPH_EMPTY to 0x0FFFFFFF, to not overlap with PANGO_GLYPH_UNKNOWN_FLAG (0x10000000). Define PANGO_GET_UNKNOWN_GLYPH(wc) that simply returns wc|PANGO_GLYPH_UNKNOWN_FLAG. * docs/pango-sections.txt, docs/tmpl/glyphs.sgml: Document new symbols. * modules/*/*.c: Use PANGO_GET_UNKNOWN_GLYPH instead of various backend-specific functions. * pango/pangofc-font.c, pango/pangoft.c, pango/pangoxft-font.c, * pango/pangowin32.c, pango/pangox.c: Suggest using PANGO_GET_UNKNOWN_GLYPH in docs. * pango/pangofc-font.h: Deprecate pango_fc_font_get_unknown_glyph(). * pango/pangowin32.h: Deprecate pango_win32_get_unknown_glyph().
Diffstat (limited to 'pango/pangoft2.c')
-rw-r--r--pango/pangoft2.c8
1 files changed, 5 insertions, 3 deletions
diff --git a/pango/pangoft2.c b/pango/pangoft2.c
index 901cd99a..be53cac4 100644
--- a/pango/pangoft2.c
+++ b/pango/pangoft2.c
@@ -470,10 +470,12 @@ pango_ft2_font_get_coverage (PangoFont *font,
* pango_ft2_get_unknown_glyph:
* @font: a #PangoFont
*
- * Return the index of a glyph suitable for drawing unknown characters,
- * or %PANGO_GLYPH_EMPTY if no suitable glyph found.
+ * Return the index of a glyph suitable for drawing unknown characters with
+ * @font, or %PANGO_GLYPH_EMPTY if no suitable glyph found.
*
- * For most uses, pango_fc_font_get_unknown_glyph() should be used instead.
+ * If you want to draw an unknown-box for a character that is not covered
+ * by the font,
+ * use PANGO_GET_UNKNOWN_GLYPH() instead.
*
* Return value: a glyph index into @font, or %PANGO_GLYPH_EMPTY
**/