javadoc and note about broken semantics for findIndex