First set of documentation for files.cf

Using existing documentation from comments as much as possible. Needs review and more work.