Enable breadth-first search for :find.

Add the option, p_bfs, to control whether we use BFS or DFS in
file_search.c.

Run `:set breadthfirst` to enable this behaviour.

closes #1035
Update docs for 'breadthfirst'.