Improve docs, and mention g_unichar_iszerowidth().

2007-01-04  Behdad Esfahbod  <behdad@gnome.org>

        * pango/pango-utils.c: Improve docs, and mention
        g_unichar_iszerowidth().

svn path=/trunk/; revision=2127

diff --git a/ChangeLog b/ChangeLog
index afb5c96..85aa8d5 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2007-01-04  Behdad Esfahbod  <behdad@gnome.org>
 
+       * pango/pango-utils.c: Improve docs, and mention
+       g_unichar_iszerowidth().
+
+2007-01-04  Behdad Esfahbod  <behdad@gnome.org>
+
        Part of Bug 332266 – gdk_draw_layout fails for coordinates >= 2^21
 
        * pango/pango-types.h:

diff --git a/pango/pango-utils.c b/pango/pango-utils.c
index ec1ba16..c39a9cd 100644 (file)
--- a/pango/pango-utils.c
+++ b/pango/pango-utils.c
@@ -1748,8 +1748,11 @@ pango_find_base_dir (const gchar *text,
  * pango_is_zero_width:
  * @ch: a Unicode character
  *
- * Checks @ch to see if it is a zero-width character that should not be
- * normally rendered on the screen.
+ * Checks @ch to see if it is a character that should not be
+ * normally rendered on the screen.  This includes all Unicode characters
+ * with "ZERO WIDTH" in their name, as well as bidi formatting characters, and
+ * a few other ones.  This is totally different from g_unichar_iszerowidth()
+ * and is at best misnamed.
  *
  * Return value: %TRUE if @ch is a zero-width character, %FALSE otherwise
  *