Comparison function implementation doesn't match the javadoc

[ayush-finix]

See: https://github.com/JavaMoney/jsr354-api/issues/153

I'm assuming it would make sense to just change the java doc, since the existing implementation is the intuitive understanding of how most comparison functions are read.