diff -r 26200f535296 Doc/c-api/unicode.rst --- a/Doc/c-api/unicode.rst Wed Oct 03 13:53:28 2012 +0530 +++ b/Doc/c-api/unicode.rst Thu Oct 04 10:02:46 2012 +0300 @@ -1083,8 +1083,6 @@ After completion, *\*byteorder* is set to the current byte order at the end of input data. - In a narrow build codepoints outside the BMP will be decoded as surrogate pairs. - If *byteorder* is *NULL*, the codec starts in native order mode. Return *NULL* if an exception was raised by the codec. diff -r 26200f535296 Doc/reference/lexical_analysis.rst --- a/Doc/reference/lexical_analysis.rst Wed Oct 03 13:53:28 2012 +0530 +++ b/Doc/reference/lexical_analysis.rst Thu Oct 04 10:02:46 2012 +0300 @@ -538,9 +538,7 @@ this escape sequence. Exactly four hex digits are required. (6) - Any Unicode character can be encoded this way, but characters outside the Basic - Multilingual Plane (BMP) will be encoded using a surrogate pair if Python is - compiled to use 16-bit code units (the default). Exactly eight hex digits + Any Unicode character can be encoded this way. Exactly eight hex digits are required. diff -r 26200f535296 Include/unicodeobject.h --- a/Include/unicodeobject.h Wed Oct 03 13:53:28 2012 +0530 +++ b/Include/unicodeobject.h Thu Oct 04 10:02:46 2012 +0300 @@ -1022,8 +1022,7 @@ /* Create a Unicode Object from the given Unicode code point ordinal. - The ordinal must be in range(0x10000) on narrow Python builds - (UCS2), and range(0x110000) on wide builds (UCS4). A ValueError is + The ordinal must be in range(0x110000). A ValueError is raised in case it is not. */ diff -r 26200f535296 Objects/unicodeobject.c --- a/Objects/unicodeobject.c Wed Oct 03 13:53:28 2012 +0530 +++ b/Objects/unicodeobject.c Thu Oct 04 10:02:46 2012 +0300 @@ -5772,18 +5772,12 @@ void *data; Py_ssize_t expandsize = 0; - /* Initial allocation is based on the longest-possible unichr + /* Initial allocation is based on the longest-possible character escape. - In wide (UTF-32) builds '\U00xxxxxx' is 10 chars per source - unichr, so in this case it's the longest unichr escape. In - narrow (UTF-16) builds this is five chars per source unichr - since there are two unichrs in the surrogate pair, so in narrow - (UTF-16) builds it's not the longest unichr escape. - - In wide or narrow builds '\uxxxx' is 6 chars per source unichr, - so in the narrow (UTF-16) build case it's the longest unichr - escape. + For UCS1 strings it's '\xxx', 4 bytes per source character. + For UCS2 strings it's '\uxxxx', 6 bytes per source character. + For UCS4 strings it's '\U00xxxxxx', 10 bytes per source character. */ if (!PyUnicode_Check(unicode)) {