Revised version of a contribution from Gerrit Holl.

Update the docs for the extended behavior of __contains__