-clarify API (#2661)

diff --git a/src/include/gnunet_core_service.h b/src/include/gnunet_core_service.h
index c648c3ce01e6c4a61567d6bdac5a778fd1fc6af0..ca4048b5229cf1fb41991baf63e20103be2de118 100644 (file)
--- a/src/include/gnunet_core_service.h
+++ b/src/include/gnunet_core_service.h
@@ -131,7 +131,9 @@ struct GNUNET_CORE_MessageHandler
  * for good).  Note that the private key of the peer is intentionally
  * not exposed here; if you need it, your process should try to read
  * the private key file directly (which should work if you are
- * authorized...).
+ * authorized...).  Implementations of this function must not call
+ * GNUNET_CORE_disconnect (other than by scheduling a new task to
+ * do this later).
  *
  * @param cls closure
  * @param server handle to the server, NULL if we failed