Added javadoc

Hopefully that's a good start... 
Would it make sense to link this to the regular iterator javadoc, so that the relationship is clear?