Document vertx/file_system and all the attendant bits and pieces.

This meant doing a little refactoring of ReadStream and WriteStream, as
well as documenting Pump and AsyncFile. As much as possible, this is an
attempt to align the existing Java interfaces to Javascript objects,
mixins, classes and modules.