diff --git a/envoy/network/io_handle.h b/envoy/network/io_handle.h
index 644228762fc51..a960887a56a1c 100644
--- a/envoy/network/io_handle.h
+++ b/envoy/network/io_handle.h
@@ -108,6 +108,7 @@ class IoHandle {
    * Send a message to the address.
    * @param slices points to the location of data to be sent.
    * @param num_slice indicates number of slices |slices| contains.
+   * @param flags flags to pass to the underlying sendmsg function (see man 2 sendmsg).
    * @param self_ip is the source address whose port should be ignored. Nullptr
    * if caller wants kernel to select source address.
    * @param peer_address is the destination address.
@@ -202,7 +203,6 @@ class IoHandle {
   /**
    * Bind to address. The handle should have been created with a call to socket()
    * @param address address to bind to.
-   * @param addrlen address length
    * @return a Api::SysCallIntResult with rc_ = 0 for success and rc_ = -1 for failure. If the call
    *   is successful, errno_ shouldn't be used.
    */
@@ -220,7 +220,6 @@ class IoHandle {
    * Accept on listening handle
    * @param addr remote address to be returned
    * @param addrlen remote address length
-   * @param flags flags to be applied to accepted session
    * @return accepted IoHandlePtr
    */
   virtual std::unique_ptr<IoHandle> accept(struct sockaddr* addr, socklen_t* addrlen) PURE;
@@ -229,7 +228,6 @@ class IoHandle {
    * Connect to address. The handle should have been created with a call to socket()
    * on this object.
    * @param address remote address to connect to.
-   * @param addrlen remote address length
    * @return a Api::SysCallIntResult with rc_ = 0 for success and rc_ = -1 for failure. If the call
    *   is successful, errno_ shouldn't be used.
    */