Improve javadoc for KeysIndex

patch by plin reviewed by dbrosius for cassandra-7253