Document Pyerr_Warn().
Document Pyerr_Warn().

Add an XXX comment at the beginning expressing disappointment over the
confusing way refcount behavior of arguments is documented.

sk-/python2.7-type-annotator,sk-/python2.7-type-annotator,sk-/python2.7-type-annotator