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().
In fact, I will move such a NOTE to the recv_cb where it belongs.