LUCENE-6271: fix javadocs, don't @see yourself, and make it clear you don't get positions unless you ask