Fix bugs in locking and removal

Previous revision broke token iteration without locks and introduced a
syntax error in the Pool.remove() method.
Pydoc documentation

Most methods now have (short) documentation in pydoc format.