2 files changed, 4 insertions, 4 deletions

diff --git a/src/include/gnunet_connection_lib.h b/src/include/gnunet_connection_lib.h
index 0051e5fb5..960d4d730 100644
--- a/src/include/gnunet_connection_lib.h
+++ b/src/include/gnunet_connection_lib.h
@@ -296,8 +296,8 @@ struct GNUNET_CONNECTION_TransmitHandle;
 
 /**
  * Ask the connection to call us once the specified number of bytes
- * are free in the transmission buffer.  May call the notify
- * method immediately if enough space is available.  Note that
+ * are free in the transmission buffer.  Will never call the @a notify
+ * callback in this task, but always first go into the scheduler.  Note that
  * this function will abort if "size" is greater than
  * #GNUNET_SERVER_MAX_MESSAGE_SIZE.
  *
diff --git a/src/util/connection.c b/src/util/connection.c
index fb20617fd..2bb128abc 100644
--- a/src/util/connection.c
+++ b/src/util/connection.c
@@ -1367,8 +1367,8 @@ SCHEDULE_WRITE:
 
 /**
  * Ask the connection to call us once the specified number of bytes
- * are free in the transmission buffer.  May call the notify
- * method immediately if enough space is available.
+ * are free in the transmission buffer.  Will never call the @a notify
+ * callback in this task, but always first go into the scheduler.
  *
  * @param connection connection
  * @param size number of bytes to send