some small improvements to IndexWriter's top-level javadoc based on recent threads on java-dev/java-user