updated API doc for socket.h