Looking at the patch years later, I'm thinking that this isn't needed or helpful.  Not needed because users haven't reported any misunderstandings in the interim.  Not helpful because the text looks forbidding and impenetrable, too much for a simple method like __len__().

I recommend closing this as out-of-date.  As Benjamin noted, the advent of __length_hint__ has mostly made this issue go away.