*** empty log message ***

1 files changed, 6 insertions, 0 deletions

diff --git a/lib/gnutls_record.c b/lib/gnutls_record.c
index 82fbcb679e..cbde6b6306 100644
--- a/lib/gnutls_record.c
+++ b/lib/gnutls_record.c
@@ -476,10 +476,13 @@ int ret = GNUTLS_E_UNIMPLEMENTED_FEATURE;
   * In case of GNUTLS_SHUT_RDWR then the TLS connection gets terminated and
   * further receives and sends will be disallowed. If the return
   * value is zero you may continue using the connection.
+  * (GNUTLS_SHUT_RDWR actually sends an alert containing a close request
+  * and waits for the peer to reply with the same message)
   *
   * In case of GNUTLS_SHUT_WR then the TLS connection gets terminated and
   * further sends will be disallowed. In order to reuse the connection
   * you should wait for an EOF from the peer.
+  * (GNUTLS_SHUT_WR sends an alert containing a close request)
   *
   * This function may also return GNUTLS_E_AGAIN, or GNUTLS_E_INTERRUPTED.
   *
@@ -1193,6 +1196,9 @@ size_t gnutls_get_max_record_size( GNUTLS_STATE state) {
   * get in effect immediately. It will be used after a successful
   * handshake.
   *
+  * This function uses a TLS extension called 'max record size'.
+  * Not all TLS implementations use or even understand this extension.
+  *
   **/
 size_t gnutls_set_max_record_size( GNUTLS_STATE state, size_t size) {
 size_t new_size;