maybe we can document `opts.filename` as well?