Don't know if it's just me being thick, but I'd love to
see the docs changed from talking about 'owned' and
'unowned' references to talking about 'new' and
Not only would this make things more consistent with
the Python API documentation, but also more explicit.
When I read the explanation that something returned an
'owned' reference I thought 'well, of course it's owned
by *someone*', but it wasn't clear whether it was owned
by the caller or callee. Only after looking up the
docs for PyString_FromString() was I able to figure out
the section on Class Object.