Add comments to document parameters of Dart_NativeEntryResolver.

runtime/include/dart_api.h

Index: runtime/include/dart_api.h
===================================================================
--- runtime/include/dart_api.h	(revision 31502)
+++ runtime/include/dart_api.h	(working copy)
@@ -2133,6 +2133,18 @@
  * name/arity to a Dart_NativeFunction. If no function is found, the
  * callback should return NULL.
  *
+ * The parameters to the native resolver function are:
+ * \param name a Dart string which is the name of the native function.
+ * \param num_of_arguments is the number of arguments expected by the
+ *   native function.
+ * \param auto_setup_scope is a boolean flag that can be set by the resolver
+ *   to indicate if this function needs a Dart API scope (see Dart_EnterScope/
+ *   Dart_ExitScope) to be setup automatically by the VM before calling into
+ *   the native function. By default most native functions would require this
+ *   to be true but some light weight native functions which do not call back
+ *   into the VM through the Dart API may not require a Dart scope to be
+ *   setup automatically.
+ *

[srdjan, 2014/01/06 21:22:19]

Document return value as well.

[siva, 2014/01/06 21:27:02]

Done.

  * See Dart_SetNativeResolver.
  */
 typedef Dart_NativeFunction (*Dart_NativeEntryResolver)(Dart_Handle name,