From 58f92d48c984e6f51b5dcac2fb28d737725b1017 Mon Sep 17 00:00:00 2001
From: Tatsuhiro Tsujikawa <tatsuhiro.t@gmail.com>
Date: Sun, 23 Dec 2012 01:24:56 +0900
Subject: [PATCH] Add remarks about callbacks and spdylay_session_{recv,send}

---
 doc/apiref-header.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/apiref-header.rst b/doc/apiref-header.rst
index cdd836f9..b4c3a4c9 100644
--- a/doc/apiref-header.rst
+++ b/doc/apiref-header.rst
@@ -7,3 +7,13 @@ Includes
 To use the public APIs, include ``spdylay/spdylay.h``::
 
     #include <spdylay/spdylay.h>
+
+Remarks
+-------
+
+Do not call `spdylay_session_send`, `spdylay_session_recv` or
+`spdylay_session_mem_recv` from the spdylay callback functions
+directly or indirectly. It will lead to the crash. You can submit
+requests or frames in the callbacks then call `spdylay_session_send`,
+`spdylay_session_recv` or `spdylay_session_mem_recv` outside of the
+callbacks.