Issue 1163367: Clarify super() docs.  Also, fix-up the markup and XXX comment.
Issue 1163367: Clarify super() docs.  Also, fix-up the markup and XXX comment.

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