Implemented Java's contracts in Point's equals method.

Also implemented the comparable interface and its method in anticipation
of eventually having to sort points.
Update documentation in Point class.