Add comments for the 2 search methods

And puts the methods in a format the doc generation understands.