Rename dispatch() to dispatch_for()

To better align with other Mbed functions.

Author: adbridge

events/include/events/EventQueue.h

@@ -88,14 +88,14 @@ class EventQueue : private mbed::NonCopyable<EventQueue> {
 
     /** Dispatch events
      *
-     *  Executes events until the specified milliseconds have passed.
+     *  Executes events for the specified number of milliseconds.
      *
-     *  The dispatch function is guaranteed to terminate after the elapsed wait
+     *  The dispatch_for() function is guaranteed to terminate after the elapsed wait.
      *
      *  @param ms       Time to wait for events in milliseconds, expressed as a
      *                  Chrono duration.
      */
-    void dispatch(duration ms);
+    void dispatch_for(duration ms);
 
     /** Dispatch events
      *
@@ -111,7 +111,7 @@ class EventQueue : private mbed::NonCopyable<EventQueue> {
      *                  value will dispatch events indefinitely
      *                  (default to -1)
      */
-    MBED_DEPRECATED_SINCE("mbed-os-6.7.0", "Pass a chrono duration, not an integer millisecond count. For example use `5s` rather than `5000`.")
+    MBED_DEPRECATED_SINCE("mbed-os-6.7.0", "Use dispatch_for() to pass a chrono duration, not an integer millisecond count. For example use `5s` rather than `5000`.")
     void dispatch(int ms = -1);
 
     /** Dispatch events without a timeout