Change docs to reflect and explain the changes in code.
Attempt a make a sensible __eq__().