Missing documentation on how to write custom iterators

[daniele-rapagnani]

In the Iterator section of the docs we should explain that custom iterators can be built by overloading the iterator operator by setting the symbols.iterator property on an Object to a function.

An example can be found here.