From 7e06c9f506f35a90bf6b49b3b2cd4a56a3de0efb Mon Sep 17 00:00:00 2001
From: Tim Otten <totten@civicrm.org>
Date: Tue, 6 Jan 2015 11:41:10 -0800
Subject: [PATCH] INFRA-132 - CRM/Report - Convert single-line @param to
 multi-line

---
 CRM/Report/BAO/ReportInstance.php |  6 ++++--
 CRM/Report/Form.php               | 13 ++++++++-----
 CRM/Report/Form/Extended.php      |  3 ++-
 CRM/Report/Page/Options.php       |  3 ++-
 CRM/Report/Utils/Report.php       |  6 ++++--
 5 files changed, 20 insertions(+), 11 deletions(-)

diff --git a/CRM/Report/BAO/ReportInstance.php b/CRM/Report/BAO/ReportInstance.php
index 271248870b..2c922ec227 100644
--- a/CRM/Report/BAO/ReportInstance.php
+++ b/CRM/Report/BAO/ReportInstance.php
@@ -42,7 +42,8 @@ class CRM_Report_BAO_ReportInstance extends CRM_Report_DAO_ReportInstance {
    * instance object. the params array could contain additional unused name/value
    * pairs
    *
-   * @param array  $params (reference ) an assoc array of name/value pairs
+   * @param array $params
+   *   (reference ) an assoc array of name/value pairs.
    *
    * @return CRM_Report_DAO_ReportInstance object
    * @static
@@ -122,7 +123,8 @@ class CRM_Report_BAO_ReportInstance extends CRM_Report_DAO_ReportInstance {
    *
    * This function is invoked from within the web form layer and also from the api layer
    *
-   * @param array   $params      (reference ) an assoc array of name/value pairs
+   * @param array $params
+   *   (reference ) an assoc array of name/value pairs.
    *
    * @return CRM_Report_BAO_ReportInstance object
    * @static
diff --git a/CRM/Report/Form.php b/CRM/Report/Form.php
index 9b0dbb4fd2..506fb6cc61 100644
--- a/CRM/Report/Form.php
+++ b/CRM/Report/Form.php
@@ -1626,8 +1626,8 @@ class CRM_Report_Form extends CRM_Core_Form {
    * @todo - could not find any instances where this is called
    *
    * @param unknown_type $relative
-   * @param String $from
-   * @param String_type $to
+   * @param string $from
+   * @param string_type $to
    *
    * @return string|NULL
    */
@@ -3533,7 +3533,8 @@ LEFT JOIN civicrm_contact {$field['alias']} ON {$field['alias']}.id = {$this->_a
   /**
    * Does table name have columns in SELECT clause?
    *
-   * @param string $tableName Name of table (index of $this->_columns array)
+   * @param string $tableName
+   *   Name of table (index of $this->_columns array).
    *
    * @return bool
    */
@@ -3601,8 +3602,10 @@ LEFT JOIN civicrm_contact {$field['alias']} ON {$field['alias']}.id = {$this->_a
    *
    * adding address fields to construct function in reports
    *
-   * @param bool $groupBy Add GroupBy? Not appropriate for detail report
-   * @param bool $orderBy Add GroupBy? Not appropriate for detail report
+   * @param bool $groupBy
+   *   Add GroupBy? Not appropriate for detail report.
+   * @param bool $orderBy
+   *   Add GroupBy? Not appropriate for detail report.
    * @param bool $filters
    * @param array $defaults
    *
diff --git a/CRM/Report/Form/Extended.php b/CRM/Report/Form/Extended.php
index e6adeb9527..851b65debe 100644
--- a/CRM/Report/Form/Extended.php
+++ b/CRM/Report/Form/Extended.php
@@ -698,7 +698,8 @@ class CRM_Report_Form_Extended extends CRM_Report_Form {
 
   /*
    * adding address fields to construct function in reports
-   * @param array $options Options for the report
+   * @param array $options
+   *   Options for the report.
    * - prefix prefix to add (e.g. 'honor' when getting address details for honor contact
    * - prefix_label optional prefix lable eg. "Honoree " for front end
    * - group_by enable these fields for group by - default false
diff --git a/CRM/Report/Page/Options.php b/CRM/Report/Page/Options.php
index a603e1c8fd..37dfde714d 100644
--- a/CRM/Report/Page/Options.php
+++ b/CRM/Report/Page/Options.php
@@ -213,7 +213,8 @@ class CRM_Report_Page_Options extends CRM_Core_Page_Basic {
   /**
    * Get userContext params
    *
-   * @param int $mode mode that we are in
+   * @param int $mode
+   *   Mode that we are in.
    *
    * @return string
    */
diff --git a/CRM/Report/Utils/Report.php b/CRM/Report/Utils/Report.php
index 23e364e695..62de36c2b2 100644
--- a/CRM/Report/Utils/Report.php
+++ b/CRM/Report/Utils/Report.php
@@ -456,8 +456,10 @@ WHERE  inst.report_id = %1";
    * stipulated in $_GET or in a report Preview, but which haven't yet been
    * saved in the report instance.
    *
-   * @param array $defaults The report criteria that aren't coming in as submitted form values, as in CRM_Report_Form::_defaults
-   * @param array $params All effective report criteria, as in CRM_Report_Form::_params
+   * @param array $defaults
+   *   The report criteria that aren't coming in as submitted form values, as in CRM_Report_Form::_defaults.
+   * @param array $params
+   *   All effective report criteria, as in CRM_Report_Form::_params.
    *
    * @return string URL query string
    */
-- 
2.25.1