added docs and defaults for gather_files