Move some code around, improve documentation
diff --git a/include/polarssl/ssl.h b/include/polarssl/ssl.h
index e15efad..50ff986 100644
--- a/include/polarssl/ssl.h
+++ b/include/polarssl/ssl.h
@@ -1422,7 +1422,10 @@
int ssl_handshake_step( ssl_context *ssl );
/**
- * \brief Perform an SSL renegotiation on the running connection
+ * \brief Initiate an SSL renegotiation on the running connection.
+ * Client: perform the renegotiation right now.
+ * Server: request renegotiation, which will be performed
+ * during the next call to ssl_read() if honored by client.
*
* \param ssl SSL context
*