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().
Please separate this last sentence with a new line, and add a "NOTE:" to it so it stands out.