LUCENE-886: cleanup: javadoc improvements; don't print exceptions to stderr but re-throw them; new test case