Fix comments.

include/core/federated/network/socket_common.h

@@ -241,13 +241,12 @@ void write_to_socket_fail_on_error(int* socket, size_t num_bytes, unsigned char*
                                    char* format, ...);
 
 /**
- * @brief Gracefully shuts down and closes a socket, optionally reading until EOF.
  * Shutdown and close the socket. If read_before_closing is false, it just immediately calls shutdown() with SHUT_RDWR
  * and close(). If read_before_closing is true, it calls shutdown with SHUT_WR, only disallowing further writing. Then,
  * it calls read() until EOF is received, and discards all received bytes.
  * @param socket Pointer to the socket descriptor to shutdown and close.
  * @param read_before_closing If true, read until EOF before closing the socket.
- * @return int Returns 0 on success, -1 on failure (errno will indicate the error).
+ * @return int 0 for success and -1 for an error.
  */
 int shutdown_socket(int* socket, bool read_before_closing);