Improve JavaDocs of methods taking coordinate in canonical form

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.