improve docs for the file filter