Improve javadoc for KeysIndex

patch by plin reviewed by dbrosius for cassandra-7253
Merge branch 'cassandra-2.0' into cassandra-2.1