table.iterator: add some documentation