Clarified threading issues
diff --git a/include/polarssl/threading.h b/include/polarssl/threading.h
index 4afaeea..ceb1277 100644
--- a/include/polarssl/threading.h
+++ b/include/polarssl/threading.h
@@ -56,7 +56,7 @@
* \brief Set your alternate threading implementation function
* pointers
*
- * \param mutex_init the malloc function implementation
+ * \param mutex_init the init function implementation
* \param mutex_free the free function implementation
* \param mutex_lock the lock function implementation
* \param mutex_unlock the unlock function implementation
@@ -71,6 +71,8 @@
/*
* The function pointers for mutex_init, mutex_free, mutex_ and mutex_unlock
+ *
+ * All these functions are expected to work or the result will be undefined.
*/
extern int (*polarssl_mutex_init)( threading_mutex_t *mutex );
extern int (*polarssl_mutex_free)( threading_mutex_t *mutex );