Python's definition of a character does not match that
of Unicode.  Python's documentation should, at a
minimum, explain how python definition compares to
Unicode's definition of a code unit, code point, glyph,
grapheme cluster, or character.

Unicode's definition of a character can be found here:
http://unicode.org/reports/tr17/

Python seems to use the Code Units option given here:
http://www.unicode.org/faq/char_combmark.html#7

Logged In: YES 
user_id=21627

The Python string type is not at all Unicode compliant, so I
don't see a need to use Unicode terminology to explain it.

Logged In: YES 
user_id=12364

Sorry, I wasn't clear.  I only intended this to be about the
unicode type.

Logged In: YES 
user_id=21627

Ok. Can you come up with a patch?

Logged In: YES 
user_id=12364

Not at the moment.

Anyone brave enough can find the mentioned definitions in the thread
below. Reading all of it is necessary, as there are some contradictory
quotes and interpretations before an agreement is (sort of) achieved.

http://mail.python.org/pipermail/python-dev/2008-July/080886.html

See this talk for an explanation of the various Unicode terms and how
they map to Python's implementation:

http://www.egenix.com/library/presentations/#PythonAndUnicode

Also note that the Unicode standard has evolved a lot since Unicode
support was added to Python in late 1999. Some terms used in Python
differ from those used in Unicode 5.0 or have been defined in more
strict ways than were common at the time.

And finally: don't forget that Python provides ways of *working* with
Unicode, i.e. it does not guarantee that a Python Unicode string always
contains all code points required for e.g. UTF-16. It is well possible
to store lone surrogates and invalid or unassigned code points in a
Python Unicode string.

Without patch, I don't see how this issue can be moved forward.

Adding a list of such Unicode term definitions would at best cause additional confusion and only address people knowledgable in the Unicode field.

Note that Python's use of code units and code points matches those of the Unicode standard in most respects. Glyphs and all higher-level definitions are out-of-scope for Python.