From 0ae3d02b4946942052311459c9904064a1b6feed Mon Sep 17 00:00:00 2001
From: David Knoll <david@futurefirst.org.uk>
Date: Tue, 30 Sep 2014 23:31:18 +0100
Subject: [PATCH] Add phpdoc comment to random recipients function

---
 CRM/Mailing/BAO/Recipients.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/CRM/Mailing/BAO/Recipients.php b/CRM/Mailing/BAO/Recipients.php
index a4fc9e6525..b5e11acb01 100644
--- a/CRM/Mailing/BAO/Recipients.php
+++ b/CRM/Mailing/BAO/Recipients.php
@@ -85,6 +85,16 @@ WHERE  mailing_id = %1
     return CRM_Core_DAO::executeQuery($sql, $params);
   }
 
+  /**
+   * Moves a number of randomly-chosen recipients of one Mailing to another Mailing.
+   *
+   * @param int $mailingIdC
+   *   Source mailing ID
+   * @param int $newMailingID
+   *   Destination mailing ID
+   * @param int $totalLimit
+   *   Number of recipients to move
+   */
   static function updateRandomRecipients($mailingIdC, $newMailingID, $totalLimit = NULL) {
     $limitString = NULL;
     if ($totalLimit) {
-- 
2.25.1