search-api: lucene should not store unneeded field data.

This commit also contains minor changes in the javadoc.