base: File API

Missing:

* Docs as docbook, fix typos etc
There is a fail method.  The events are now gone.