Added list state to file module

Useful for testing purposes so that the state of a file can
be interrogated without fear of changing it

Also fixed some minor typos in the documentation