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.
God damn, I double checked that I got them all and everything. I suck. Fixed.