rust-lang/rust — pull request #15897 by Gankro (2014-07-22 14:03:39+00:00)
Title: clarifying iterator trait documentation

I found these things to be ambiguous, or at least worth stating explicitly to reduce the amount a user/developer needs to think about the API.