Deprecate old debugger breakpoint handler

runtime/include/dart_debugger_api.h

 // Copyright (c) 2011, 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_DEBUGGER_API_H_
 #define INCLUDE_DART_DEBUGGER_API_H_
 
 #include "include/dart_api.h"
 
 typedef struct _Dart_Breakpoint* Dart_Breakpoint;
 
 typedef struct _Dart_StackTrace* Dart_StackTrace;
 
 typedef struct _Dart_ActivationFrame* Dart_ActivationFrame;
 
 /**
  * An id used to uniquely represent an Isolate in the debugger wire protocol
  * messages.
  */
 typedef Dart_Port Dart_IsolateId;
 
 /**
  * ILLEGAL_ISOLATE_ID is a number guaranteed never to be associated with a
  * valid isolate.
  */
 #define ILLEGAL_ISOLATE_ID ILLEGAL_PORT
 
+// DEPRECATED -- use Dart_PausedEventHandler
 typedef void Dart_BreakpointHandler(Dart_IsolateId isolate_id,
                                     Dart_Breakpoint breakpoint,
                                     Dart_StackTrace stack_trace);
 
 typedef void Dart_BreakpointResolvedHandler(Dart_IsolateId isolate_id,
                                             intptr_t bp_id,
                                             Dart_Handle url,
                                             intptr_t line_number);
 
 typedef void Dart_ExceptionThrownHandler(Dart_IsolateId isolate_id,
@@ skipping 13 matching lines @@
 typedef struct {
   Dart_Handle script_url;  // Url (string) of the script.
   int32_t library_id;      // Library in which the script is loaded.
   int32_t token_pos;       // Code address.
 } Dart_CodeLocation;
 
 
 typedef void Dart_IsolateEventHandler(Dart_IsolateId isolate_id,
                                       Dart_IsolateEvent kind);
 
+typedef void Dart_PausedEventHandler(Dart_IsolateId isolate_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
  * resumes.
  *
  * Requires there to be a current isolate.
  *
  * Returns an id >= 0 on success, or -1 if there is an error.
  */
 DART_EXPORT intptr_t Dart_CacheObject(Dart_Handle object_in);
@@ skipping 198 matching lines @@
 /**
  * Can be called from the breakpoint handler. Causes the debugger to
  * break after returning from the current Dart function.
  *
  * Requires there to be a current isolate.
  */
 DART_EXPORT Dart_Handle Dart_SetStepOut();
 
 
 /**
+ * DEPRECATED -- use Dart_SetPausedEventHandler
+ *
  * Installs a handler callback function that gets called by the VM
  * when a breakpoint has been reached.
  *
  * Requires there to be a current isolate.
  */
 DART_EXPORT void Dart_SetBreakpointHandler(
                             Dart_BreakpointHandler bp_handler);
 
+
+/**
+ * Installs a handler callback function that gets called by the VM
+ * when a breakpoint location has been reached or when stepping.
+ *
+ * Requires there to be a current isolate.
+ */
+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.
  *
  * Requires there to be a current isolate.
  */
 DART_EXPORT void Dart_SetBreakpointResolvedHandler(
                             Dart_BreakpointResolvedHandler handler);
 
 /**
@@ skipping 309 matching lines @@
  * \param request A REST-like string, which uses '/' to separate
  *     parameters. The first parameter is always the status type.
  *
  * \return The requested status as a JSON formatted string, with the
  *     contents defined by the status plug-in. The caller is responsible
  *     for freeing this string.
  */
 DART_EXPORT char* Dart_GetVmStatus(const char* request);
 
 #endif  // INCLUDE_DART_DEBUGGER_API_H_