fix equality-checking methods
change keyword argument notations in the examples