VM: Re-format to use at most one newline between functions

runtime/include/dart_tools_api.h

Index: runtime/include/dart_tools_api.h
diff --git a/runtime/include/dart_tools_api.h b/runtime/include/dart_tools_api.h
index 270ce8140f90f0008223c5134f534f6845419fa8..d13f960dec22674432fe9fa3cdf7f82ff185a124 100644
--- a/runtime/include/dart_tools_api.h
+++ b/runtime/include/dart_tools_api.h
@@ -17,7 +17,6 @@
  * This reference is generated from the header include/dart_tools_api.h.
  */
 
-
 /*
   * ========
   * Debugger
@@ -41,14 +40,12 @@ typedef Dart_Port Dart_IsolateId;
  */
 #define ILLEGAL_ISOLATE_ID ILLEGAL_PORT
 
-
 /**
  * Null value for breakpoint id. Guaranteed never to be associated
  * with a valid breakpoint.
  */
 #define ILLEGAL_BREAKPOINT_ID 0
 
-
 typedef void Dart_ExceptionThrownHandler(Dart_IsolateId isolate_id,
                                          Dart_Handle exception_object,
                                          Dart_StackTrace stack_trace);
@@ -59,7 +56,6 @@ typedef enum {
   kShutdown,
 } Dart_IsolateEvent;
 
-
 /**
  * Represents a location in Dart code.
  */
@@ -69,7 +65,6 @@ typedef struct {
   int32_t token_pos;       // Code address.
 } Dart_CodeLocation;
 
-
 typedef void Dart_IsolateEventHandler(Dart_IsolateId isolate_id,
                                       Dart_IsolateEvent kind);
 
@@ -81,7 +76,6 @@ typedef void Dart_BreakpointResolvedHandler(Dart_IsolateId isolate_id,
                                             intptr_t bp_id,
                                             const Dart_CodeLocation& location);
 
-
 /**
  * Caches a given \object and returns an object id. The object id is only
  * valid while the VM is paused. The cache is invalidated when the VM
@@ -93,7 +87,6 @@ typedef void Dart_BreakpointResolvedHandler(Dart_IsolateId isolate_id,
  */
 DART_EXPORT intptr_t Dart_CacheObject(Dart_Handle object_in);
 
-
 /**
  * Returns a cached object given the \obj_id.
  *
@@ -101,7 +94,6 @@ DART_EXPORT intptr_t Dart_CacheObject(Dart_Handle object_in);
  */
 DART_EXPORT Dart_Handle Dart_GetCachedObject(intptr_t obj_id);
 
-
 /**
  * Returns a list of ids (integers) of all the libraries loaded in the
  * current isolate.
@@ -112,7 +104,6 @@ DART_EXPORT Dart_Handle Dart_GetCachedObject(intptr_t obj_id);
  */
 DART_EXPORT Dart_Handle Dart_GetLibraryIds();
 
-
 /**
  * Returns true if the debugger can step into code of the given library.
  *
@@ -123,7 +114,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryIds();
 DART_EXPORT Dart_Handle Dart_GetLibraryDebuggable(intptr_t library_id,
                                                   bool* is_debuggable);
 
-
 /**
  * Requets that debugging be enabled for the given library.
  *
@@ -134,7 +124,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryDebuggable(intptr_t library_id,
 DART_EXPORT Dart_Handle Dart_SetLibraryDebuggable(intptr_t library_id,
                                                   bool is_debuggable);
 
-
 /**
  * Returns a list of urls (strings) of all the scripts loaded in the
  * given library.
@@ -145,7 +134,6 @@ DART_EXPORT Dart_Handle Dart_SetLibraryDebuggable(intptr_t library_id,
  */
 DART_EXPORT Dart_Handle Dart_GetScriptURLs(Dart_Handle library_url);
 
-
 /**
  * Returns a string containing the source code of the given script
  * in the given library.
@@ -158,7 +146,6 @@ DART_EXPORT Dart_Handle Dart_GetScriptURLs(Dart_Handle library_url);
 DART_EXPORT Dart_Handle Dart_ScriptGetSource(intptr_t library_id,
                                              Dart_Handle script_url_in);
 
-
 /**
  * Returns an array containing line number and token offset info
  * for the given script.
@@ -179,7 +166,6 @@ DART_EXPORT Dart_Handle Dart_ScriptGetSource(intptr_t library_id,
 DART_EXPORT Dart_Handle Dart_ScriptGetTokenInfo(intptr_t library_id,
                                                 Dart_Handle script_url_in);
 
-
 /**
  * Returns a string containing a generated source code of the given script
  * in the given library. This is essentially used to pretty print dart code
@@ -193,7 +179,6 @@ DART_EXPORT Dart_Handle Dart_ScriptGetTokenInfo(intptr_t library_id,
 DART_EXPORT Dart_Handle Dart_GenerateScriptSource(Dart_Handle library_url_in,
                                                   Dart_Handle script_url_in);
 
-
 /**
  * Sets a breakpoint at line \line_number in \script_url, or the closest
  * following line (within the same function) where a breakpoint can be set.
@@ -215,7 +200,6 @@ DART_EXPORT Dart_Handle Dart_SetBreakpoint(Dart_Handle script_url,
  */
 DART_EXPORT Dart_Handle Dart_RemoveBreakpoint(intptr_t bp_id);
 
-
 /**
  * Get the script URL of the breakpoint with the given id \pb_id.
  *
@@ -226,7 +210,6 @@ DART_EXPORT Dart_Handle Dart_RemoveBreakpoint(intptr_t bp_id);
  */
 DART_EXPORT Dart_Handle Dart_GetBreakpointURL(intptr_t bp_id);
 
-
 /**
  * Get the line number of the breakpoint with the given id \pb_id.
  *
@@ -237,7 +220,6 @@ DART_EXPORT Dart_Handle Dart_GetBreakpointURL(intptr_t bp_id);
  */
 DART_EXPORT Dart_Handle Dart_GetBreakpointLine(intptr_t bp_id);
 
-
 /**
  * Sets a one-time breakpoint at the entry of the given function.
  * If class_name is the empty string, looks for a library function
@@ -252,7 +234,6 @@ DART_EXPORT Dart_Handle Dart_SetBreakpointAtEntry(Dart_Handle library,
                                                   Dart_Handle class_name,
                                                   Dart_Handle function_name);
 
-
 /**
  * Sets a breakpoint at the entry of the given function. If class_name
  * is the empty string, looks for a library function with the given
@@ -266,7 +247,6 @@ DART_EXPORT Dart_Handle Dart_OneTimeBreakAtEntry(Dart_Handle library,
                                                  Dart_Handle class_name,
                                                  Dart_Handle function_name);
 
-
 /**
  * Can be called from the breakpoint handler. Sets the debugger to
  * single step mode.
@@ -275,7 +255,6 @@ DART_EXPORT Dart_Handle Dart_OneTimeBreakAtEntry(Dart_Handle library,
  */
 DART_EXPORT Dart_Handle Dart_SetStepOver();
 
-
 /**
  * Can be called from the breakpoint handler. Causes the debugger to
  * break after at the beginning of the next function call.
@@ -284,7 +263,6 @@ DART_EXPORT Dart_Handle Dart_SetStepOver();
  */
 DART_EXPORT Dart_Handle Dart_SetStepInto();
 
-
 /**
  * Can be called from the breakpoint handler. Causes the debugger to
  * break after returning from the current Dart function.
@@ -293,7 +271,6 @@ DART_EXPORT Dart_Handle Dart_SetStepInto();
  */
 DART_EXPORT Dart_Handle Dart_SetStepOut();
 
-
 /**
  * Installs a handler callback function that gets called by the VM
  * when a breakpoint location has been reached or when stepping.
@@ -302,7 +279,6 @@ DART_EXPORT Dart_Handle Dart_SetStepOut();
  */
 DART_EXPORT void Dart_SetPausedEventHandler(Dart_PausedEventHandler handler);
 
-
 /**
  * Installs a callback function that gets called by the VM when
  * a breakpoint has been resolved to an actual url and line number.
@@ -346,7 +322,6 @@ typedef enum {
 DART_EXPORT Dart_Handle
 Dart_SetExceptionPauseInfo(Dart_ExceptionPauseInfo pause_info);
 
-
 /**
  * Returns on which exceptions the debugger pauses.
  *
@@ -364,7 +339,6 @@ DART_EXPORT Dart_ExceptionPauseInfo Dart_GetExceptionPauseInfo();
  */
 DART_EXPORT Dart_Handle Dart_GetStackTrace(Dart_StackTrace* trace);
 
-
 /**
  * Returns in \trace the stack trace associated with the error given in \handle.
  *
@@ -375,7 +349,6 @@ DART_EXPORT Dart_Handle Dart_GetStackTrace(Dart_StackTrace* trace);
 DART_EXPORT Dart_Handle Dart_GetStackTraceFromError(Dart_Handle error,
                                                     Dart_StackTrace* trace);
 
-
 /**
  * Returns in \length the number of activation frames in the given
  * stack trace.
@@ -387,7 +360,6 @@ DART_EXPORT Dart_Handle Dart_GetStackTraceFromError(Dart_Handle error,
 DART_EXPORT Dart_Handle Dart_StackTraceLength(Dart_StackTrace trace,
                                               intptr_t* length);
 
-
 /**
  * Returns in \frame the activation frame with index \frame_index.
  * The activation frame at the top of stack has index 0.
@@ -400,7 +372,6 @@ DART_EXPORT Dart_Handle Dart_GetActivationFrame(Dart_StackTrace trace,
                                                 int frame_index,
                                                 Dart_ActivationFrame* frame);
 
-
 /**
  * Returns information about the given activation frame.
  * \function_name receives a string handle with the qualified
@@ -424,7 +395,6 @@ Dart_ActivationFrameInfo(Dart_ActivationFrame activation_frame,
                          intptr_t* line_number,
                          intptr_t* column_number);
 
-
 /**
  * Returns code location of the given activation frame.
  *
@@ -481,7 +451,6 @@ Dart_ActivationFrameGetFramePointer(Dart_ActivationFrame activation_frame,
 DART_EXPORT Dart_Handle
 Dart_GetLocalVariables(Dart_ActivationFrame activation_frame);
 
-
 /**
  * Returns origin class of a function.
  *
@@ -493,7 +462,6 @@ Dart_GetLocalVariables(Dart_ActivationFrame activation_frame);
  */
 DART_EXPORT Dart_Handle Dart_GetFunctionOrigin(Dart_Handle function);
 
-
 /**
  * Returns an array containing all the global variable names and values of
  * the library with given \library_id.
@@ -506,7 +474,6 @@ DART_EXPORT Dart_Handle Dart_GetFunctionOrigin(Dart_Handle function);
  */
 DART_EXPORT Dart_Handle Dart_GetGlobalVariables(intptr_t library_id);
 
-
 /**
  * Execute the expression given in string \expr in the context
  * of stack frame \activation_frame.
@@ -515,7 +482,6 @@ DART_EXPORT Dart_Handle
 Dart_ActivationFrameEvaluate(Dart_ActivationFrame activation_frame,
                              Dart_Handle expr_in);
 
-
 /**
  * Execute the expression given in string \expr in the context
  * of \target.
@@ -536,7 +502,6 @@ Dart_ActivationFrameEvaluate(Dart_ActivationFrame activation_frame,
  */
 DART_EXPORT Dart_Handle Dart_EvaluateExpr(Dart_Handle target, Dart_Handle expr);
 
-
 /**
  * Returns the class of the given \object.
  *
@@ -546,7 +511,6 @@ DART_EXPORT Dart_Handle Dart_EvaluateExpr(Dart_Handle target, Dart_Handle expr);
  */
 DART_EXPORT Dart_Handle Dart_GetObjClass(Dart_Handle object);
 
-
 /**
  * Returns in \class_id the class id of the given \object. The id is valid
  * for the lifetime of the isolate.
@@ -558,7 +522,6 @@ DART_EXPORT Dart_Handle Dart_GetObjClass(Dart_Handle object);
 DART_EXPORT Dart_Handle Dart_GetObjClassId(Dart_Handle object,
                                            intptr_t* class_id);
 
-
 /**
  * Returns the supertype of the given instantiated type \cls.
  *
@@ -568,7 +531,6 @@ DART_EXPORT Dart_Handle Dart_GetObjClassId(Dart_Handle object,
  */
 DART_EXPORT Dart_Handle Dart_GetSupertype(Dart_Handle type);
 
-
 /**
  * Returns handle to class with class id \class_id.
  *
@@ -578,7 +540,6 @@ DART_EXPORT Dart_Handle Dart_GetSupertype(Dart_Handle type);
  */
 DART_EXPORT Dart_Handle Dart_GetClassFromId(intptr_t class_id);
 
-
 /**
  * Returns info about the given class \cls_id.
  *
@@ -601,7 +562,6 @@ DART_EXPORT Dart_Handle Dart_GetClassInfo(intptr_t class_id,
                                           intptr_t* super_class_id,
                                           Dart_Handle* static_fields);
 
-
 /** Returns info about the given closure \closure.
  *
  * \param name receives handle to closure name (string).
@@ -622,7 +582,6 @@ DART_EXPORT Dart_Handle Dart_GetClosureInfo(Dart_Handle closure,
                                             Dart_Handle* signature,
                                             Dart_CodeLocation* location);
 
-
 /**
  * Returns an array containing all instance field names and values of
  * the given \object.
@@ -637,7 +596,6 @@ DART_EXPORT Dart_Handle Dart_GetClosureInfo(Dart_Handle closure,
  */
 DART_EXPORT Dart_Handle Dart_GetInstanceFields(Dart_Handle object);
 
-
 /**
  * Returns an array containing all static field names and values of
  * the given type \target.
@@ -652,7 +610,6 @@ DART_EXPORT Dart_Handle Dart_GetInstanceFields(Dart_Handle object);
  */
 DART_EXPORT Dart_Handle Dart_GetStaticFields(Dart_Handle target);
 
-
 /**
  * Returns a handle to the library \library_id.
  *
@@ -662,7 +619,6 @@ DART_EXPORT Dart_Handle Dart_GetStaticFields(Dart_Handle target);
  */
 DART_EXPORT Dart_Handle Dart_GetLibraryFromId(intptr_t library_id);
 
-
 /**
  * Returns in \library_id the library id of the given \library.
  *
@@ -671,7 +627,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryFromId(intptr_t library_id);
 DART_EXPORT Dart_Handle Dart_LibraryId(Dart_Handle library,
                                        intptr_t* library_id);
 
-
 /**
  * Returns an array containing all variable names and values of
  * the given library \library_id.
@@ -686,7 +641,6 @@ DART_EXPORT Dart_Handle Dart_LibraryId(Dart_Handle library,
  */
 DART_EXPORT Dart_Handle Dart_GetLibraryFields(intptr_t library_id);
 
-
 /**
  * Returns an array containing all imported libraries of
  * the given library \library_id.
@@ -702,7 +656,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryFields(intptr_t library_id);
  */
 DART_EXPORT Dart_Handle Dart_GetLibraryImports(intptr_t library_id);
 
-
 /**
  * Returns the url of the library \library_id.
  *
@@ -712,7 +665,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryImports(intptr_t library_id);
  */
 DART_EXPORT Dart_Handle Dart_GetLibraryURL(intptr_t library_id);
 
-
 /**
  * Returns the isolate object corresponding to the isolate id.
  *
@@ -721,7 +673,6 @@ DART_EXPORT Dart_Handle Dart_GetLibraryURL(intptr_t library_id);
  */
 DART_EXPORT Dart_Isolate Dart_GetIsolate(Dart_IsolateId isolate_id);
 
-
 /**
  * Returns the isolate id for an isolate.
  *
@@ -729,7 +680,6 @@ DART_EXPORT Dart_Isolate Dart_GetIsolate(Dart_IsolateId isolate_id);
  */
 DART_EXPORT Dart_IsolateId Dart_GetIsolateId(Dart_Isolate isolate);
 
-
 /*
  * =======
  * Service
@@ -781,7 +731,6 @@ typedef bool (*Dart_ServiceRequestCallback)(const char* method,
                                             void* user_data,
                                             const char** json_object);
 
-
 /**
  * Register a Dart_ServiceRequestCallback to be called to handle
  * requests for the named rpc on a specific isolate. The callback will
@@ -799,7 +748,6 @@ DART_EXPORT void Dart_RegisterIsolateServiceRequestCallback(
     Dart_ServiceRequestCallback callback,
     void* user_data);
 
-
 /**
  * Register a Dart_ServiceRequestCallback to be called to handle
  * requests for the named rpc. The callback will be invoked without a
@@ -817,7 +765,6 @@ DART_EXPORT void Dart_RegisterRootServiceRequestCallback(
     Dart_ServiceRequestCallback callback,
     void* user_data);
 
-
 /*
  * ========
  * Event Streams
@@ -952,7 +899,6 @@ DART_EXPORT int64_t Dart_TimelineGetMicros();
 /** Disable all timeline stream recording */
 #define DART_TIMELINE_STREAM_DISABLE 0
 
-
 /**
  * Start recording timeline events for the entire VM (including all isolates).
  *
@@ -962,7 +908,6 @@ DART_EXPORT int64_t Dart_TimelineGetMicros();
  */
 DART_EXPORT void Dart_GlobalTimelineSetRecordedStreams(int64_t stream_mask);
 
-
 typedef enum {
   /** Indicates a new stream is being output */
   Dart_StreamConsumer_kStart = 0,