Added kwarg to return a list created from the generator in file_search().
file_search(): Removed kwarg to return a list and provided more
exhaustive documenting on the generator output.