Remove the partially completed code for remote IsolateMirrors and

runtime/include/dart_api.h

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 #ifndef INCLUDE_DART_API_H_
 #define INCLUDE_DART_API_H_
 
 /** \mainpage Dart Embedding API Reference
  *
  * Dart is a class-based programming language for creating structured
@@ skipping 517 matching lines @@
 DART_EXPORT void Dart_ShutdownIsolate();
 // TODO(turnidge): Document behavior when there is no current isolate.
 
 /**
  * Returns the current isolate. Will return NULL if there is no
  * current isolate.
  */
 DART_EXPORT Dart_Isolate Dart_CurrentIsolate();
 
 /**
+ * Returns the debugging name for the current isolate.
+ *
+ * This name is unique to each isolate and should only be used to make
+ * debugging messages more comprehensible.
+ */
+DART_EXPORT Dart_Handle Dart_DebugName();
+
+/**
  * Enters an isolate. After calling this function,
  * the current isolate will be set to the provided isolate.
  *
  * Requires there to be no current isolate.
  */
 DART_EXPORT void Dart_EnterIsolate(Dart_Isolate isolate);
 // TODO(turnidge): Describe what happens if two threads attempt to
 // enter the same isolate simultaneously. Check for this in the code.
 // Describe whether isolates are allowed to migrate.
 
@@ skipping 559 matching lines @@
 
 /**
  * Returns a String built from the provided C string
  *
  * \param value A C String
  *
  * \return The String object if no error occurs. Otherwise returns
  *   an error handle.
  */
 DART_EXPORT Dart_Handle Dart_NewString(const char* str);
+// TODO(turnidge): Document what happens when we run out of memory
+// during this call.
 
 /**
  * Returns a String built from an array of 8-bit codepoints.
  *
  * \param value An array of 8-bit codepoints.
  * \param length The length of the codepoints array.
  *
  * \return The String object if no error occurs. Otherwise returns
  *   an error handle.
  */
@@ skipping 653 matching lines @@
  * \param arguments An array of arguments to the function.
  *
  * \return If the function or method is called and completes
  *   successfully, then the return value is returned. If an error
  *   occurs during execution, then an error handle is returned.
  */
 DART_EXPORT Dart_Handle Dart_Invoke(Dart_Handle target,
                                     Dart_Handle name,
                                     int number_of_arguments,
                                     Dart_Handle* arguments);
+// TODO(turnidge): Document how to invoke operators.
 
 /**
  * Gets the value of a field.
  *
  * The 'container' parameter may be an object, class, or library.  If
  * 'container' is an object, then this function will access an
  * instance field.  If 'container' is a class, then this function will
  * access a static field.  If 'container' is a library, then this
  * function will access a top-level variable.
  *
@@ skipping 36 matching lines @@
 /**
  * Creates a native wrapper class.
  *
  * TODO(turnidge): Document.
  */
 DART_EXPORT Dart_Handle Dart_CreateNativeWrapperClass(Dart_Handle library,
                                                       Dart_Handle class_name,
                                                       int field_count);
 
 /**
+ * Gets the number of native instance fields in an object.
+ */
+DART_EXPORT Dart_Handle Dart_GetNativeInstanceFieldCount(Dart_Handle obj,
+                                                         int* count);
+
+/**
  * Gets the value of a native field.
  *
  * TODO(turnidge): Document.
  */
 DART_EXPORT Dart_Handle Dart_GetNativeInstanceField(Dart_Handle obj,
                                                     int index,
                                                     intptr_t* value);
 /**
  * Sets the value of a native field.
  *
@@ skipping 153 matching lines @@
  * \param buffer A buffer which contains a snapshot of the script.
  *
  * \return If no error occurs, the Library object corresponding to the root
  *   script is returned. Otherwise an error handle is returned.
  */
 DART_EXPORT Dart_Handle Dart_LoadScriptFromSnapshot(const uint8_t* buffer);
 
 /**
  * Gets the library for the root script for the current isolate.
  *
- * \return Returns the Library object corresponding to the root script
- *   if it has been set by a successful call to Dart_LoadScript or
- *   Dart_LoadScriptFromSnapshot.  Otherwise returns Dart_Null().
+ * If the root script has not yet been set for the current isolate,
+ * this function returns Dart_Null().  This function never returns an
+ * error handle.
+ *
+ * \return Returns the root Library for the current isolate or Dart_Null().
  */
 DART_EXPORT Dart_Handle Dart_RootLibrary();
 
 /**
  * Forces all loaded classes and functions to be compiled eagerly in
  * the current isolate..
  *
  * TODO(turnidge): Document.
  */
 DART_EXPORT Dart_Handle Dart_CompileAll();
@@ skipping 10 matching lines @@
  * \param class_name The name of the class or interface.
  *
  * \return If no error occurs, the class or interface is
  *   returned. Otherwise an error handle is returned.
  */
 DART_EXPORT Dart_Handle Dart_GetClass(Dart_Handle library,
                                       Dart_Handle class_name);
 // TODO(turnidge): Consider returning Dart_Null() when the class is
 // not found to distinguish that from a true error case.
 
+/**
+ * Returns the name of a library as declared in the #library directive.
+ */
+DART_EXPORT Dart_Handle Dart_LibraryName(Dart_Handle library);
+
+/**
+ * Returns the url from which a library was loaded.
+ */
 DART_EXPORT Dart_Handle Dart_LibraryUrl(Dart_Handle library);
 
 DART_EXPORT Dart_Handle Dart_LookupLibrary(Dart_Handle url);
 // TODO(turnidge): Consider returning Dart_Null() when the library is
 // not found to distinguish that from a true error case.
 
 DART_EXPORT Dart_Handle Dart_LoadLibrary(Dart_Handle url,
                                          Dart_Handle source);
 
 
@@ skipping 20 matching lines @@
 
 // --- Profiling support ----
 
 // External pprof support for gathering and dumping symbolic
 // information that can be used for better profile reports for
 // dynamically generated code.
 DART_EXPORT void Dart_InitPprofSupport();
 DART_EXPORT void Dart_GetPprofSymbolInfo(void** buffer, int* buffer_size);
 
 #endif  // INCLUDE_DART_API_H_