[client_socket] further doc edits