Improve JavaDocs of methods taking coordinate in canonical form

[xjusko]

Descriptions in exception and internal classes was improved in SHRINKRES-113. It appears that some API methods JavaDocs still needs improvements. See last post in forum reference.

[petrberan]

Link to the original issue: https://issues.redhat.com/browse/SHRINKRES-128