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.
My un-verified belief is that functions referenced in documentation *usually* have parens. I don't think you need to go and add it to existing references, but I do think it makes sense to ensure you use parens in any new documentation you add.