improves doc comment

The previous doc comment was not correct as the predicate is not always applied to all elements. The method is actually short circuiting as soon as it the predicate does not hold for an element.