ticket:10012: Java doc comments for new APIs, some improvements in the implementation and fixing detector name for ISO-8859-8 (distinction between visual and logical/implicit).

git-svn-id: http://source.icu-project.org/repos/icu/icu4j/branches/yoshito@34258 251d0590-4201-4cf1-90de-194747b24ca1