diff -r 54f6d8c4dfaf Doc/c-api/unicode.rst --- a/Doc/c-api/unicode.rst Sat Apr 06 20:31:26 2013 -0500 +++ b/Doc/c-api/unicode.rst Sun Apr 07 00:23:53 2013 -0400 @@ -727,8 +727,11 @@ .. c:function:: PyObject* PyUnicode_FromObject(PyObject *obj) - Shortcut for ``PyUnicode_FromEncodedObject(obj, NULL, "strict")`` which is used - throughout the interpreter whenever coercion to Unicode is needed. + Checks if the passed in object is already a Unicode object, and if so returns the + reference with incremented refcount. Otherwise it coerces obj to a Unicode object + and returns the reference. + + Objects other than Unicode or its subtypes will cause a :exc:`TypeError`. Locale Encoding