Explicitly document the fact that the search method returns a MatchObject.

(Reported by Gary Herron.)