| Index: ppapi/api/ppb_messaging.idl
|
| diff --git a/ppapi/api/ppb_messaging.idl b/ppapi/api/ppb_messaging.idl
|
| index dc50788e26db2c0fbfbd9824e260c4ae76f5a8d2..5100f5f5ed879ef6e764cbcaab7367276eb00750 100644
|
| --- a/ppapi/api/ppb_messaging.idl
|
| +++ b/ppapi/api/ppb_messaging.idl
|
| @@ -86,9 +86,6 @@ interface PPB_Messaging {
|
| void PostMessage([in] PP_Instance instance, [in] PP_Var message);
|
|
|
| /**
|
| - * <strong>Note:</strong> This function is not yet implemented. Please use
|
| - * PPB_Messaging_1_0.
|
| - *
|
| * Registers a handler for receiving messages from JavaScript. If a handler
|
| * is registered this way, it will replace PPP_Messaging, and all messages
|
| * sent from JavaScript via postMessage and postMessageAndAwaitResponse will
|
| @@ -99,6 +96,12 @@ interface PPB_Messaging {
|
| * <code>message_loop</code> is attached, when <code>message_loop</code> is
|
| * run. It is illegal to pass the main thread message loop;
|
| * RegisterMessageHandler will return PP_ERROR_WRONG_THREAD in that case.
|
| + * If you quit <code>message_loop</code> before calling Unregister(),
|
| + * the browser will not be able to call functions in the plugin's message
|
| + * handler any more. That could mean missing some messages or could cause a
|
| + * leak if you depend on Destroy() to free hander data. So you should,
|
| + * whenever possible, Unregister() the handler prior to quitting its event
|
| + * loop.
|
| *
|
| * Attempting to register a message handler when one is already registered
|
| * will cause the current MessageHandler to be unregistered and replaced. In
|
| @@ -123,9 +126,6 @@ interface PPB_Messaging {
|
| [in] PPP_MessageHandler handler,
|
| [in] PP_Resource message_loop);
|
| /**
|
| - * <strong>Note:</strong> This function is not yet implemented. Please use
|
| - * PPB_Messaging_1_0.
|
| - *
|
| * Unregisters the current message handler for <code>instance</code> if one
|
| * is registered. After this call, the message handler (if one was
|
| * registered) will have "Destroy" called on it and will receive no further
|
|
|