I see I've introduced Lots Of "verbiage" for nothing ...

Will I be wrong another time if I suggest little mods in doc (to alert newbees and not CompatibilityAware people like me, that this function "... does not always return the first occurence ...")?