[Python-Dev] New Py_UNICODE doc

["Martin v. Löwis"]

Nicholas Bastin wrote:
> All of my proposals for what to change the documention to have been 
> shot down by Martin.  If someone has better verbiage that they'd like 
> to see, I'd be perfectly happy to patch the doc.

I don't look into the specific wording - you speak English much better
than I do. What I care about is that this part of the documentation
should be complete and precise. I.e. statements like "should not make
assumptions" might be fine, as long as they are still followed by
a precise description of what the code currently does. So it should
mention that the representation can be either 2 or 4 bytes, that
the strings "ucs2" and "ucs4" can be used to select one of them,
that it is always 2 bytes on Windows, that 2 bytes means that non-BMP
characters can be represented as surrogate pairs, and so on.

Regards,
Martin