small documentation added, renamed variable
channels are bad as iterators, using callback for now

the problem with channels is e.g. that if the loop exits early,
a channel might never be closed, leading to "garbage".