see #8631 - Sanity checks in geometry functions dealing with coordinates + javadoc

git-svn-id: http://josm.openstreetmap.de/svn/trunk@5980 0c6e7542-c601-0410-84e7-c038aed88b3b