From: Karl Williamson <public@khwilliamson.com>
Date: Thu, 4 Apr 2013 03:59:16 +0000 (-0600)
Subject: utf8.h: Clarify comments
X-Git-Tag: upstream/5.20.0~2089^2~16
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=f710bf0c914270e8b2b3f6c31e2fd6246aa8a762;p=platform%2Fupstream%2Fperl.git

utf8.h: Clarify comments
---

diff --git a/utf8.h b/utf8.h
index 574fd7a..45353ea 100644
--- a/utf8.h
+++ b/utf8.h
@@ -202,12 +202,12 @@ Perl's extended UTF-8 means we can have start bytes up to FF.
 
 /* This defines the 1-bits that are to be in the first byte of a multi-byte
  * UTF-8 encoded character that give the number of bytes that comprise the
- * character.
- * */
+ * character. 'len' is the number of bytes in the multi-byte sequence. */
 #define UTF_START_MARK(len) (((len) >  7) ? 0xFF : (0xFF & (0xFE << (7-(len)))))
 
 /* Masks out the initial one bits in a start byte, leaving the real data ones.
- * Doesn't work on an invariant byte */
+ * Doesn't work on an invariant byte.  'len' is the number of bytes in the
+ * multi-byte sequence that comprises the character. */
 #define UTF_START_MASK(len) (((len) >= 7) ? 0x00 : (0x1F >> ((len)-2)))
 
 /* This defines the bits that are to be in the continuation bytes of a multi-byte