From 96fc21e40bfa4d903b7fd519ca2f48d4b777bd01 Mon Sep 17 00:00:00 2001 From: Paul Pearce Date: Thu, 15 Oct 2015 12:50:48 -0700 Subject: [PATCH] Document the local-only behavior of Task.retry() max_retries --- celery/app/task.py | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/celery/app/task.py b/celery/app/task.py index 4b422c90d4c..76c4d1f2ff0 100644 --- a/celery/app/task.py +++ b/celery/app/task.py @@ -571,10 +571,12 @@ def retry(self, args=None, kwargs=None, exc=None, throw=True, :keyword countdown: Time in seconds to delay the retry for. :keyword eta: Explicit time and date to run the retry at (must be a :class:`~datetime.datetime` instance). - :keyword max_retries: If set, overrides the default retry limit. - A value of :const:`None`, means "use the default", so if you want - infinite retries you would have to set the :attr:`max_retries` - attribute of the task to :const:`None` first. + :keyword max_retries: If set, overrides the default retry limit for + this execution. Changes to this parameter do not propagate to + subsequent task retry attempts. A value of :const:`None`, means + "use the default", so if you want infinite retries you would + have to set the :attr:`max_retries` attribute of the task to + :const:`None` first. :keyword time_limit: If set, overrides the default time limit. :keyword soft_time_limit: If set, overrides the default soft time limit.