Index: ppapi/api/ppp_message_handler.idl |
diff --git a/ppapi/api/ppp_message_handler.idl b/ppapi/api/ppp_message_handler.idl |
index e898f0b5971f1b5c530d8fb31c5557dac044452d..7d760401a3bf0ee48461b2b0a8ccd21d86485ef2 100644 |
--- a/ppapi/api/ppp_message_handler.idl |
+++ b/ppapi/api/ppp_message_handler.idl |
@@ -32,7 +32,7 @@ interface PPP_MessageHandler { |
* @param[in] instance A <code>PP_Instance</code> identifying one instance |
* of a module. |
* @param[in] user_data is the same pointer which was provided by a call to |
- * RegisterMessageHandler. |
+ * RegisterMessageHandler(). |
* @param[in] message A copy of the parameter that JavaScript provided to |
* postMessage(). |
*/ |
@@ -43,14 +43,19 @@ interface PPP_MessageHandler { |
* Invoked as a result of JavaScript invoking postMessageAndAwaitResponse() |
* on the plugin's DOM element. |
* |
+ * NOTE: JavaScript execution is blocked during the duration of this call. |
+ * Hence, the plugin should respond as quickly as possible. For this reason, |
+ * blocking completion callbacks are disallowed while handling a blocking |
+ * message. |
+ * |
* @param[in] instance A <code>PP_Instance</code> identifying one instance |
* of a module. |
* @param[in] user_data is the same pointer which was provided by a call to |
- * RegisterMessageHandler. |
+ * RegisterMessageHandler(). |
* @param[in] message is a copy of the parameter that JavaScript provided |
- * to postMessageAndAwaitResponse. |
+ * to postMessageAndAwaitResponse(). |
* @param[out] response will be copied to a JavaScript object which is |
- * returned as the result of postMessageAndAwaitResponse to the invoking |
+ * returned as the result of postMessageAndAwaitResponse() to the invoking |
JavaScript. |
*/ |
void HandleBlockingMessage([in] PP_Instance instance, |