From: Victor Stinner <victor.stinner@haypocalc.com>
Date: Sat, 1 Oct 2011 00:39:37 +0000 (+0200)
Subject: PyUnicode_CHARACTER_SIZE(): add a reference to PyUnicode_KIND_SIZE()
X-Git-Tag: v3.3.0a1~1416
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=4584a5ba1ab223d273b1678ba6ec3a2781a824f7;p=thirdparty%2FPython%2Fcpython.git

PyUnicode_CHARACTER_SIZE(): add a reference to PyUnicode_KIND_SIZE()
---

diff --git a/Include/unicodeobject.h b/Include/unicodeobject.h
index 9f3f66da3ffc..c41d7871c817 100644
--- a/Include/unicodeobject.h
+++ b/Include/unicodeobject.h
@@ -338,7 +338,9 @@ PyAPI_DATA(PyTypeObject) PyUnicodeIter_Type;
 
 
 /* Return the number of bytes the string uses to represent single characters,
-   this can be 1, 2 or 4. */
+   this can be 1, 2 or 4.
+
+   See also PyUnicode_KIND_SIZE(). */
 #define PyUnicode_CHARACTER_SIZE(op) \
     (1 << (PyUnicode_KIND(op) - 1))
 
@@ -378,8 +380,9 @@ PyAPI_DATA(PyTypeObject) PyUnicodeIter_Type;
      _PyUnicode_NONCOMPACT_DATA(op))
 
 /* Compute (index * char_size) where char_size is 2 ** (kind - 1).
+   The index is a character index, the result is a size in bytes.
 
-   The index is a character index, the result is a size in bytes. */
+   See also PyUnicode_CHARACTER_SIZE(). */
 #define PyUnicode_KIND_SIZE(kind, index) ((index) << ((kind) - 1))
 
 /* In the access macros below, "kind" may be evaluated more than once.