base: File API

Missing:

* Docs as docbook, fix typos etc
I agree.  Done.