documentation does not seem to specify what the iterator returns

[wchristian]

i can get this information by reading the code, but i think the documentation should talk a little about what exactly the iterator returns