Improve documentation of mbedtls_ssl_write()
diff --git a/ChangeLog b/ChangeLog
index aaf34fc..c3db587 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -54,6 +54,8 @@
Wilson #481
* Improve the documentation of mbedtls_net_accept(). Contributed by Ivan
Krylov.
+ * Improve the documentation of mbedtls_ssl_write(). Suggested by
+ Paul Sokolovsky in #1356.
= mbed TLS 2.8.0 branch released 2018-03-16
diff --git a/include/mbedtls/ssl.h b/include/mbedtls/ssl.h
index f7a1a01..e1d64b9 100644
--- a/include/mbedtls/ssl.h
+++ b/include/mbedtls/ssl.h
@@ -2537,7 +2537,9 @@
*
* \note When this function returns MBEDTLS_ERR_SSL_WANT_WRITE/READ,
* it must be called later with the *same* arguments,
- * until it returns a positive value.
+ * until it returns a positive value. When the function returns
+ * MBEDTLS_ERR_SSL_WANT_WRITE there may be some partial
+ * data in the output buffer, however this is not yet sent.
*
* \note If the requested length is greater than the maximum
* fragment length (either the built-in limit or the one set