Documentation for stream.find() and derivatives is too sparse

The documentation for these functions is almost obscure. It mentions that a target string is searched for, but does not say that this is not a String object or null terminated array of char.

The documentation for Serial.find() says that characters are read from the buffer, but does not say that they are discarded.

The documentation for file.find() is not included in the documentation for the SD library. This function alters the file position, but this is not mentioned anywhere.

Every instance could be improved with a simple best use example.