Simplify files method signature. Add some docs.