| 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.
|
| */
|
|
|