table: fix table specific iterator functions
table: add some more documentation