API documentation cleanup.

Basically:

* use `()` for all the functions.
* Expand to 80 chars width.
* "i/o" => "I/O".
* "unix" / "Unix" => "UNIX".
* More consistency.
* Clarify that, upon EOF, the callee must call to uv_close() or uv_read_stop().
IS it not clear that UV_EOF is an error? UV_EXXX == error.