Repository: celery/celery

Issue:
Control.revoke can be get list of task ids
<!--
Please fill this template entirely and do not erase parts of it.
We reserve the right to close without a response
bug reports which are incomplete.
-->
# Checklist
<!--
To check an item on the list replace [ ] with [x].
-->

- [x] I have checked the [issues list](https://github.com/celery/celery/issues?utf8=%E2%9C%93&q=is%3Aissue+label%3A%22Category%3A+Documentation%22+)
  for similar or identical bug reports.
- [x] I have checked the [pull requests list](https://github.com/celery/celery/pulls?q=is%3Apr+label%3A%22Category%3A+Documentation%22)
  for existing proposed fixes.
- [x] I have checked the [commit log](https://github.com/celery/celery/commits/master)
  to find out if the bug was already fixed in the master branch.
- [x] I have included all related issues and possible duplicate issues in this issue
      (If there are none, check this box anyway).

## Related Issues and Possible Duplicates
<!--
Please make sure to search and mention any related issues
or possible duplicates to this issue as requested by the checklist above.

This may or may not include issues in other repositories that the Celery project
maintains or other repositories that are dependencies of Celery.

If you don't know how to mention issues, please refer to Github's documentation
on the subject: https://help.github.com/en/articles/autolinked-references-and-urls#issues-and-pull-requests
-->

#### Related Issues

- None

#### Possible Duplicates

- None

# Description
<!--
Please describe what's missing or incorrect about our documentation.
Include links and/or screenshots which will aid us to resolve the issue.
-->
The existing documentation does not show the option to send some tasks ids

# Suggestions
<!-- Please provide us suggestions for how to fix the documentation -->
Update the document


Discussion:

Resolving patch:
diff --git a/celery/app/control.py b/celery/app/control.py
--- a/celery/app/control.py
+++ b/celery/app/control.py
@@ -217,13 +217,15 @@ def election(self, id, topic, action=None, connection=None):
 
     def revoke(self, task_id, destination=None, terminate=False,
                signal=TERM_SIGNAME, **kwargs):
-        """Tell all (or specific) workers to revoke a task by id.
+        """Tell all (or specific) workers to revoke a task by id
+        (or list of ids).
 
         If a task is revoked, the workers will ignore the task and
         not execute it after all.
 
         Arguments:
-            task_id (str): Id of the task to revoke.
+            task_id (Union(str, list)): Id of the task to revoke
+                (or list of ids).
             terminate (bool): Also terminate the process currently working
                 on the task (if any).
             signal (str): Name of signal to send to process if terminate.
@@ -240,7 +242,8 @@ def revoke(self, task_id, destination=None, terminate=False,
 
     def terminate(self, task_id,
                   destination=None, signal=TERM_SIGNAME, **kwargs):
-        """Tell all (or specific) workers to terminate a task by id.
+        """Tell all (or specific) workers to terminate a task by id
+        (or list of ids).
 
         See Also:
             This is just a shortcut to :meth:`revoke` with the terminate


Test patch: