Clarify delay time (#41167)

Author: driesvints

src/Illuminate/Bus/Queueable.php

@@ -127,7 +127,7 @@ public function allOnQueue($queue)
     }
 
     /**
-     * Set the desired delay for the job.
+     * Set the desired delay in seconds for the job.
      *
      * @param  \DateTimeInterface|\DateInterval|int|null  $delay
      * @return $this

src/Illuminate/Contracts/Mail/Mailable.php

@@ -23,7 +23,7 @@ public function send($mailer);
     public function queue(Queue $queue);
 
     /**
-     * Deliver the queued message after the given delay.
+     * Deliver the queued message after (n) seconds.
      *
      * @param  \DateTimeInterface|\DateInterval|int  $delay
      * @param  \Illuminate\Contracts\Queue\Factory  $queue

src/Illuminate/Contracts/Queue/Job.php

@@ -33,9 +33,7 @@ public function payload();
     public function fire();
 
     /**
-     * Release the job back into the queue.
-     *
-     * Accepts a delay specified in seconds.
+     * Release the job back into the queue after (n) seconds.
      *
      * @param  int  $delay
      * @return void

src/Illuminate/Contracts/Queue/Queue.php

@@ -43,7 +43,7 @@ public function pushOn($queue, $job, $data = '');
     public function pushRaw($payload, $queue = null, array $options = []);
 
     /**
-     * Push a new job onto the queue after a delay.
+     * Push a new job onto the queue after (n) seconds.
      *
      * @param  \DateTimeInterface|\DateInterval|int  $delay
      * @param  string|object  $job
@@ -54,7 +54,7 @@ public function pushRaw($payload, $queue = null, array $options = []);
     public function later($delay, $job, $data = '', $queue = null);
 
     /**
-     * Push a new job onto the queue after a delay.
+     * Push a new job onto a specific queue after (n) seconds.
      *
      * @param  string  $queue
      * @param  \DateTimeInterface|\DateInterval|int  $delay

src/Illuminate/Events/QueuedClosure.php

@@ -80,7 +80,7 @@ public function onQueue($queue)
     }
 
     /**
-     * Set the desired delay for the job.
+     * Set the desired delay in seconds for the job.
      *
      * @param  \DateTimeInterface|\DateInterval|int|null  $delay
      * @return $this

src/Illuminate/Foundation/Bus/PendingChain.php

@@ -91,7 +91,7 @@ public function onQueue($queue)
     }
 
     /**
-     * Set the desired delay for the chain.
+     * Set the desired delay in seconds for the chain.
      *
      * @param  \DateTimeInterface|\DateInterval|int|null  $delay
      * @return $this

src/Illuminate/Foundation/Bus/PendingDispatch.php

@@ -88,7 +88,7 @@ public function allOnQueue($queue)
     }
 
     /**
-     * Set the desired delay for the job.
+     * Set the desired delay in seconds for the job.
      *
      * @param  \DateTimeInterface|\DateInterval|int|null  $delay
      * @return $this

src/Illuminate/Mail/Mailable.php

@@ -233,7 +233,7 @@ public function queue(Queue $queue)
     }
 
     /**
-     * Deliver the queued message after the given delay.
+     * Deliver the queued message after (n) seconds.
      *
      * @param  \DateTimeInterface|\DateInterval|int  $delay
      * @param  \Illuminate\Contracts\Queue\Factory  $queue

src/Illuminate/Mail/PendingMail.php

@@ -136,7 +136,7 @@ public function queue(MailableContract $mailable)
     }
 
     /**
-     * Deliver the queued message after the given delay.
+     * Deliver the queued message after (n) seconds.
      *
      * @param  \DateTimeInterface|\DateInterval|int  $delay
      * @param  \Illuminate\Contracts\Mail\Mailable  $mailable

src/Illuminate/Queue/BeanstalkdQueue.php

@@ -110,7 +110,7 @@ public function pushRaw($payload, $queue = null, array $options = [])
     }
 
     /**
-     * Push a new job onto the queue after a delay.
+     * Push a new job onto the queue after (n) seconds.
      *
      * @param  \DateTimeInterface|\DateInterval|int  $delay
      * @param  string  $job