Updated docstring to superpose?

Can you guys tell me if this docstring makes more sense?  IMHO the previous one was pretty ambiguous about `self` versus `reference`