fix #8394 - improve javadoc + remove deprecated debug method

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