Index: runtime/include/dart_api.h |
=================================================================== |
--- runtime/include/dart_api.h (revision 43108) |
+++ runtime/include/dart_api.h (working copy) |
@@ -1949,10 +1949,16 @@ |
* \param data The internal data address is returned here. |
* \param len Size of the typed array is returned here. |
* |
- * Note: When the internal address of the object is acquired any calls to a |
- * Dart API function that could potentially allocate an object or run |
- * any Dart code will return an error. |
+ * Notes: |
+ * When the internal address of the object is acquired any calls to a |
+ * Dart API function that could potentially allocate an object or run |
+ * any Dart code will return an error. |
* |
+ * Any Dart API functions for accessing the data should not be called |
+ * before the corresponding release. In particular, the object should |
+ * not be acquired again before its release. This leads to undefined |
+ * behavior. |
+ * |
* \return Success if the internal data address is acquired successfully. |
* Otherwise, returns an error handle. |
*/ |