table/selection: fix up specs and docs
iterator: improve interface and usage
table: make match more consistent
test: fix match test