Ah, right - I forgot that it currently only implements a part of the parser API in ElementTree. Adding "Returns the toplevel document element." behind the current sentence would do, I guess. That will need updating once the XMLPullParser implements support for parser targets, though. Also, the description could just be dropped if XMLPullParser inherited from XMLParser (ticket #19010), because it's just (or should just be) a redundant repitition. All that's really new is the read_events() method and the constructor's arguments. Keeping the rest out would simplify both the interface and the documentation.