Bug 564644 – Not complete description of the

2008-12-15  Behdad Esfahbod  <behdad@gnome.org>

        Bug 564644 – Not complete description of the
        pango_font_description_better_match function

        * pango/fonts.c: Improve docs even more.

svn path=/trunk/; revision=2759

2 files changed, 13 insertions, 3 deletions

diff --git a/ChangeLog b/ChangeLog
index 55977250..7433b858 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -3,6 +3,13 @@
 	Bug 564644 – Not complete description of the
 	pango_font_description_better_match function
 
+	* pango/fonts.c: Improve docs even more.
+
+2008-12-15  Behdad Esfahbod  <behdad@gnome.org>
+
+	Bug 564644 – Not complete description of the
+	pango_font_description_better_match function
+
 	* pango/fonts.c: Improve docs.
 
 2008-12-14  Behdad Esfahbod  <behdad@gnome.org>
diff --git a/pango/fonts.c b/pango/fonts.c
index 614d6406..77d1adf6 100644
--- a/pango/fonts.c
+++ b/pango/fonts.c
@@ -625,11 +625,14 @@ compute_distance (const PangoFontDescription *a,
  * @new_match: a #PangoFontDescription
  *
  * Determines if the style attributes of @new_match are a closer match
- * for @desc than @old_match, or if @old_match is %NULL, determines if
- * @new_match is a match at all. Approximate matching is done for
+ * for @desc than those of @old_match are, or if @old_match is %NULL,
+ * determines if @new_match is a match at all.
+ * Approximate matching is done for
  * weight and style; other style attributes must match exactly.
  * Style attributes are all attributes other than family and size-related
- * attributes.
+ * attributes.  Approximate matching for style considers PANGO_STYLE_OBLIQUE
+ * and PANGO_STYLE_ITALIC as matches, but not as good a match as when the
+ * styles are equal.
  *
  * Return value: %TRUE if @new_match is a better match
  **/