Fix & improve ArrayValueMatcher JavaDoc

Fix final JavaDoc example and add new example showing how to verify
every array element using a custom comparator