doc: more docs for socket.