--- /dev/null
+# void http\Client\Curl\User::socket(resource $socket, int $poll)
+
+Register (or deregister) a socket watcher.
+
+## Params:
+
+* resource $socket
+ The socket descriptor to watch.
+* int $poll
+ http\Client\Curl\User::POLL_* constant.