docs(ngMock/$timeout): deprecate flush() and verifyNoPendingTasks()

Author: gkalpak

src/ngMock/angular-mocks.js

@@ -2268,6 +2268,13 @@ angular.mock.$TimeoutDecorator = ['$delegate', '$browser', function($delegate, $
   /**
    * @ngdoc method
    * @name $timeout#flush
+   *
+   * @deprecated
+   * sinceVersion="1.7.3"
+   *
+   * This method flushes all types of tasks (not only timeouts), which is unintuitive.
+   * It is recommended to use {@link $flushPendingTasks} instead.
+   *
    * @description
    *
    * Flushes the queue of pending tasks.
@@ -2291,6 +2298,14 @@ angular.mock.$TimeoutDecorator = ['$delegate', '$browser', function($delegate, $
   /**
    * @ngdoc method
    * @name $timeout#verifyNoPendingTasks
+   *
+   * @deprecated
+   * sinceVersion="1.7.3"
+   *
+   * This method takes all types of tasks (not only timeouts) into account, which is unintuitive.
+   * It is recommended to use {@link $verifyNoPendingTasks} instead, which additionally allows
+   * checking for timeouts only (with `$verifyNoPendingTasks('$timeout')`).
+   *
    * @description
    *
    * Verifies that there are no pending tasks that need to be flushed.