better docs for list_report