Add comments for the 2 search methods

And puts the methods in a format the doc generation understands.
s/Response/Reqest/