INFRA-132 - Move stray comments into docblocks
authorColeman Watts <coleman@civicrm.org>
Mon, 12 Jan 2015 00:18:14 +0000 (19:18 -0500)
committerColeman Watts <coleman@civicrm.org>
Mon, 12 Jan 2015 00:48:26 +0000 (19:48 -0500)
57 files changed:
CRM/Campaign/Form/Petition/Signature.php
CRM/Campaign/Info.php
CRM/Case/Info.php
CRM/Case/XMLProcessor/Settings.php
CRM/Contact/Form/Search/Custom/ActivitySearch.php
CRM/Contact/Form/Search/Custom/Base.php
CRM/Contribute/Info.php
CRM/Core/CodeGen/BaseTask.php
CRM/Core/Error.php
CRM/Core/Exception.php
CRM/Core/Payment/BaseIPN.php
CRM/Core/Payment/Moneris.php
CRM/Core/Payment/PayJunction.php
CRM/Core/Payment/PayflowPro.php
CRM/Core/Smarty/Permissions.php
CRM/Dedupe/BAO/QueryBuilder/IndividualGeneral.php
CRM/Dedupe/BAO/QueryBuilder/IndividualSupervised.php
CRM/Dedupe/BAO/RuleGroup.php
CRM/Dedupe/Merger.php
CRM/Event/Cart/BAO/Conference.php
CRM/Event/Cart/BAO/MerParticipant.php
CRM/Event/Cart/Form/MerParticipant.php
CRM/Event/Info.php
CRM/Financial/BAO/ExportFormat.php
CRM/Grant/Info.php
CRM/Mailing/BAO/Mailing.php
CRM/Mailing/BAO/MailingJob.php
CRM/Mailing/Info.php
CRM/Member/Info.php
CRM/PCP/Page/PCP.php
CRM/Pledge/Info.php
CRM/Report/Form.php
CRM/Report/Form/Contact/Detail.php
CRM/Report/Form/Contribute/History.php
CRM/Report/Form/Contribute/Lybunt.php
CRM/Report/Form/Contribute/Sybunt.php
CRM/Report/Form/Event/ParticipantListCount.php
CRM/Report/Form/Event/Summary.php
CRM/Report/Info.php
CRM/Report/Utils/Get.php
CRM/Report/Utils/Report.php
CRM/Upgrade/Incremental/php/FourThree.php
CRM/Utils/Migrate/ExportJSON.php
CRM/Utils/REST.php
CRM/Utils/Rule.php
api/Exception.php
tests/phpunit/CRM/Event/BAO/AdditionalPaymentTest.php
tests/phpunit/CiviTest/CiviSeleniumTestCase.php
tests/phpunit/CiviTest/CiviUnitTestCase.php
tests/phpunit/WebTest/Admin/MoveCustomDataTest.php
tests/phpunit/WebTest/Contact/AdvancedSearchTest.php
tests/phpunit/WebTest/Contact/CreateCmsUserFromContactTest.php
tests/phpunit/WebTest/Contact/SearchBuilderTest.php
tests/phpunit/WebTest/Contribute/OfflineContributionTest.php
tests/phpunit/WebTest/Release/InstallScript.php
tests/phpunit/WebTest/Release/ReleaseTestCase.php
tests/phpunit/WebTest/Release/UpgradeScript.php

index b694f76ae68a72b7837f1a27334f612ec69557c3..1fe046fcad08f819e18f56064a8fa47dd0fa72b6 100644 (file)
@@ -662,8 +662,8 @@ class CRM_Campaign_Form_Petition_Signature extends CRM_Core_Form {
     return parent::getTemplateFileName();
   }
 
-  // check if user has already signed this petition
   /**
+   * check if user has already signed this petition
    * @param array $params
    */
   public function redirectIfSigned($params) {
index 07a838bd9bcb438d348396363502ab9c33ddd5d8..dd54957eb9903d7a4e4e962a547fc87cc5486637 100644 (file)
@@ -40,8 +40,8 @@ class CRM_Campaign_Info extends CRM_Core_Component_Info {
   // docs inherited from interface
   protected $keyword = 'campaign';
 
-  // docs inherited from interface
   /**
+   *  docs inherited from interface
    * @return array
    */
   public function getInfo() {
@@ -55,8 +55,8 @@ class CRM_Campaign_Info extends CRM_Core_Component_Info {
   }
 
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @param bool $getAllUnconditionally
    *
    * @return array
@@ -74,8 +74,8 @@ class CRM_Campaign_Info extends CRM_Core_Component_Info {
   }
 
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return null
    */
   public function getUserDashboardElement() {
@@ -91,8 +91,8 @@ class CRM_Campaign_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return null
    */
   public function registerTab() {
@@ -100,8 +100,8 @@ class CRM_Campaign_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return null
    */
   public function registerAdvancedSearchPane() {
@@ -109,16 +109,15 @@ class CRM_Campaign_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // docs inherited from interface
   /**
-   * @return null
+   * @inheritdoc
    */
   public function getActivityTypes() {
     return NULL;
   }
 
-  // add shortcut to Create New
   /**
+   * add shortcut to Create New
    * @param $shortCuts
    */
   public function creatNewShortcut(&$shortCuts) {
index d24104ccf1662ec317776e6810707e08e847797e..86193fe143b8ac83166eb04ec4e48801c606dd0e 100644 (file)
@@ -41,8 +41,8 @@ class CRM_Case_Info extends CRM_Core_Component_Info {
   // docs inherited from interface
   protected $keyword = 'case';
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function getInfo() {
@@ -74,8 +74,8 @@ class CRM_Case_Info extends CRM_Core_Component_Info {
     return $result;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    * @throws CRM_Core_Exception
    */
@@ -88,8 +88,8 @@ class CRM_Case_Info extends CRM_Core_Component_Info {
     return $entities;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @param bool $getAllUnconditionally
    *
    * @return array
@@ -139,16 +139,16 @@ class CRM_Case_Info extends CRM_Core_Component_Info {
     return $result;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function getUserDashboardElement() {
     return array();
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function registerTab() {
@@ -159,8 +159,8 @@ class CRM_Case_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function registerAdvancedSearchPane() {
@@ -170,16 +170,16 @@ class CRM_Case_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return null
    */
   public function getActivityTypes() {
     return NULL;
   }
 
-  // add shortcut to Create New
   /**
+   * add shortcut to Create New
    * @param $shortCuts
    */
   public function creatNewShortcut(&$shortCuts) {
index a2499e661114b17a737fea794642533d2790eb7a..2622baf04354f774844d8d0ddcfa234fda34b69e 100644 (file)
@@ -36,9 +36,9 @@ class CRM_Case_XMLProcessor_Settings extends CRM_Case_XMLProcessor {
 
   private $_settings = array();
 
-  // Input: The base filename without the .xml extension
-  // Output: An array of settings.
   /**
+   * Input: The base filename without the .xml extension
+   * Output: An array of settings.
    * @param string $filename
    *
    * @return array
index c518532a9df803c0eb56a281cd4e148029af988c..2c9aeca5f0bdd8aba3bd646c82e74eca3427f08e 100644 (file)
@@ -240,17 +240,17 @@ ORDER BY contact_a.sort_name';
     return $sql;
   }
 
-  // Alters the date display in the Activity Date Column. We do this after we already have
-  // the result so that sorting on the date column stays pertinent to the numeric date value
   /**
+   * Alters the date display in the Activity Date Column. We do this after we already have
+   * the result so that sorting on the date column stays pertinent to the numeric date value
    * @param $row
    */
   public function alterRow(&$row) {
     $row['activity_date'] = CRM_Utils_Date::customFormat($row['activity_date'], '%B %E%f, %Y %l:%M %P');
   }
 
-  // Regular JOIN statements here to limit results to contacts who have activities.
   /**
+   * Regular JOIN statements here to limit results to contacts who have activities.
    * @return string
    */
   public function from() {
index 227c58efb26ec520edab052f577f607f4bc5f270..cca35084f2123b249f6b7db219a6f7cc32f77b58 100644 (file)
@@ -221,9 +221,9 @@ class CRM_Contact_Form_Search_Custom_Base {
     return CRM_Core_DAO::composeQuery($where, $params, TRUE);
   }
 
-  // override this method to define the contact query object
-  // used for creating $sql
   /**
+   * override this method to define the contact query object
+   * used for creating $sql
    * @return null
    */
   public function getQueryObj() {
index b8054e989a84a2f05a318349879fdf8142c262f1..ff71b916f74ebd8b839c84465c439d48ebebf96c 100644 (file)
@@ -41,8 +41,8 @@ class CRM_Contribute_Info extends CRM_Core_Component_Info {
   // docs inherited from interface
   protected $keyword = 'contribute';
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides base information about the component.
    * Needs to be implemented in component's information
    * class.
@@ -63,8 +63,8 @@ class CRM_Contribute_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides permissions that are used by component.
    * Needs to be implemented in component's information
    * class.
@@ -107,8 +107,8 @@ class CRM_Contribute_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about user dashboard element
    * offered by this component.
    *
@@ -128,8 +128,8 @@ class CRM_Contribute_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about user dashboard element
    * offered by this component.
    *
@@ -148,8 +148,8 @@ class CRM_Contribute_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about advanced search pane
    * offered by this component.
    *
@@ -167,8 +167,8 @@ class CRM_Contribute_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides potential activity types that this
    * component might want to register in activity history.
    * Needs to be implemented in component's information
@@ -184,8 +184,8 @@ class CRM_Contribute_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // add shortcut to Create New
   /**
+   * add shortcut to Create New
    * @param $shortCuts
    * @param $newCredit
    */
index b9890e9bf47a4d8bedfb7038e96f8c8bf6e71b17..88ac1f469d4c26e8fe09c2eab77d08250c3f0e9c 100644 (file)
@@ -11,10 +11,11 @@ abstract class CRM_Core_CodeGen_BaseTask implements CRM_Core_CodeGen_ITask {
   public function __construct() {
   }
 
-  // TODO: this is the most rudimentary possible hack.  CG config should
-  // eventually be made into a first-class object.
   /**
-   * @param is $config
+   * TODO: this is the most rudimentary possible hack.  CG config should
+   * eventually be made into a first-class object.
+   *
+   * @param object $config
    */
   public function setConfig($config) {
     $this->config = $config;
index f9c4ec35d322f044a91a637b95887710a0f745ce..6c0cff5d30d32159233d38b6601cec59fbc23efe 100644 (file)
@@ -46,8 +46,8 @@ require_once 'Log.php';
  * Class CRM_Exception
  */
 class CRM_Exception extends PEAR_Exception {
-  // Redefine the exception so message isn't optional
   /**
+   * Redefine the exception so message isn't optional
    * Supported signatures:
    *  - PEAR_Exception(string $message);
    *  - PEAR_Exception(string $message, int $code);
@@ -74,7 +74,6 @@ class CRM_Core_Error extends PEAR_ErrorStack {
 
   /**
    * Status code of various types of errors
-   * @var const
    */
   const FATAL_ERROR = 2;
   const DUPLICATE_CONTACT = 8001;
@@ -250,10 +249,11 @@ class CRM_Core_Error extends PEAR_ErrorStack {
     self::abend(1);
   }
 
-  // this function is used to trap and print errors
-  // during system initialization time. Hence the error
-  // message is quite ugly
   /**
+   * this function is used to trap and print errors
+   * during system initialization time. Hence the error
+   * message is quite ugly
+   *
    * @param $pearError
    */
   public static function simpleHandler($pearError) {
index 7be50c964af52a0681706f6cbe93675c8f882b53..ae709522034d16298cbc4af392fa95c9b7090eb5 100644 (file)
@@ -52,8 +52,8 @@ class CRM_Core_Exception extends PEAR_Exception {
     $this->errorData = $errorData + array('error_code' => $error_code);
   }
 
-  // custom string representation of object
   /**
+   * custom string representation of object
    * @return string
    */
   public function __toString() {
index 1ce44b30612294c90a6c28f597e067a4c97429d0..bfe01f76c7b818a403d0ea7c72be6258a95b38c1 100644 (file)
@@ -1017,9 +1017,8 @@ LIMIT 1;";
     return $lineSets;
   }
 
-  // function to copy custom data of the
-  // initial contribution into its recurring contributions
   /**
+   * copy custom data of the initial contribution into its recurring contributions
    * @param int $recurId
    * @param int $targetContributionId
    */
@@ -1062,9 +1061,10 @@ LIMIT 1;";
     }
   }
 
-  // function to copy soft credit record of first recurring contribution
-  // and add new soft credit against $targetContributionId
   /**
+   * copy soft credit record of first recurring contribution
+   * and add new soft credit against $targetContributionId
+   *
    * @param int $recurId
    * @param int $targetContributionId
    */
index 9f8e000e8869f259ea6ce09d9a9d0732795a42cf..48372a2c5aec6a0175b509470466081cd5df8c01 100644 (file)
@@ -253,8 +253,8 @@ class CRM_Core_Payment_Moneris extends CRM_Core_Payment {
     return TRUE;
   }
 
-  // ignore for now, more elaborate error handling later.
   /**
+   * ignore for now, more elaborate error handling later.
    * @param $response
    *
    * @return object
index e9f78a02706d96c9328a3372bbd0b1a50db48922..f6741840f600816e970ce99e7c990f9e672490cd 100644 (file)
@@ -198,8 +198,8 @@ class CRM_Core_Payment_PayJunction extends CRM_Core_Payment {
   }
 
 
-  // ignore for now, more elaborate error handling later.
   /**
+   * ignore for now, more elaborate error handling later.
    * @param $response
    *
    * @return mixed
index adbc43bcd427f5d6e0dd4566e4662584bd2e0c86..c62d3b0b14a400520958e5c25f38e145a9a65e5b 100644 (file)
@@ -410,8 +410,8 @@ class CRM_Core_Payment_PayflowPro extends CRM_Core_Payment {
 
   //  function checkConfig( $mode )          // CiviCRM V1.9 Declaration
 
-  // CiviCRM V2.0 Declaration
   /**
+   * CiviCRM V2.0 Declaration
    * This function checks to see if we have the right config values
    *
    * @internal param string $mode the mode we are operating in (live or test)
index a64389565dd004e76384a70a32ecab43caf64291..9e2f35b0062933231cb6ab8839b7ed562f32b177 100644 (file)
@@ -4,8 +4,8 @@
  * Class CRM_Core_Smarty_Permissions
  */
 class CRM_Core_Smarty_Permissions {
-  // non-static adapter for CRM_Core_Permission::check
   /**
+   * non-static adapter for CRM_Core_Permission::check
    * @param $offset
    *
    * @return bool
index f65884c162daa28d46860f2e315d5d5b9026cff3..a3670968dff17fc992b23a8a8ac554a9f06ae13d 100644 (file)
@@ -1,7 +1,7 @@
 <?php
 
-// TODO: How to handle NULL values/records?
 /**
+ * TODO: How to handle NULL values/records?
  * Class CRM_Dedupe_BAO_QueryBuilder_IndividualGeneral
  */
 class CRM_Dedupe_BAO_QueryBuilder_IndividualGeneral extends CRM_Dedupe_BAO_QueryBuilder {
index 905aef6fe2ad7791f9651d6d1092b0aedef98b49..973242b41fcf40fdbde86cf09118e0a82268602a 100644 (file)
@@ -1,7 +1,7 @@
 <?php
 
-// TODO: How to handle NULL values/records?
 /**
+ * TODO: How to handle NULL values/records?
  * Class CRM_Dedupe_BAO_QueryBuilder_IndividualSupervised
  */
 class CRM_Dedupe_BAO_QueryBuilder_IndividualSupervised extends CRM_Dedupe_BAO_QueryBuilder {
index bd7d5ec87cc0c81293af714907c24bdbcd313003..4f37b88322b3273ac080025006a6857cad3996b7 100644 (file)
@@ -271,9 +271,9 @@ class CRM_Dedupe_BAO_RuleGroup extends CRM_Dedupe_DAO_RuleGroup {
     }
   }
 
-  // Function to determine if a given query set contains inclusive or exclusive set of weights.
-  // The function assumes that the query set is already ordered by weight in desc order.
   /**
+   * Function to determine if a given query set contains inclusive or exclusive set of weights.
+   * The function assumes that the query set is already ordered by weight in desc order.
    * @param $tableQueries
    * @param $threshold
    * @param array $exclWeightSum
@@ -312,8 +312,8 @@ class CRM_Dedupe_BAO_RuleGroup extends CRM_Dedupe_DAO_RuleGroup {
     return array($totalCombinations == 1, $totalCombinations <= 0);
   }
 
-  // sort queries by number of records for the table associated with them
   /**
+   * sort queries by number of records for the table associated with them
    * @param $tableQueries
    */
   public static function orderByTableCount(&$tableQueries) {
index ac198e9cde51c8941b106f7382c1d5b4a60fc41b..009e3858b3c46ee8ea41db1bcbaae9e473373747 100644 (file)
  */
 class CRM_Dedupe_Merger {
 
-  // FIXME: consider creating a common structure with cidRefs() and eidRefs()
-  // FIXME: the sub-pages references by the URLs should
-  // be loaded dynamically on the merge form instead
   /**
+   * FIXME: consider creating a common structure with cidRefs() and eidRefs()
+   * FIXME: the sub-pages references by the URLs should
+   * be loaded dynamically on the merge form instead
    * @return array
    */
   public static function relTables() {
index d96f36aaec1c96b546c6cebde3bb7fc0399c86e8..543ec6b3aa93ebf56fc8adf6c52d243e412c1e27 100644 (file)
@@ -4,9 +4,9 @@
  * Class CRM_Event_Cart_BAO_Conference
  */
 class CRM_Event_Cart_BAO_Conference {
-  //XXX assumes we don't allow a contact to register for the same conference more than once
-  //XXX flattens the object tree for convenient templating
   /**
+   * XXX assumes we don't allow a contact to register for the same conference more than once
+   * XXX flattens the object tree for convenient templating
    * @param int $main_event_participant_id
    *
    * @return array|null
index 2731d858d89399b393796a868f542320d28f75c7..63f09d81390e30dbac124607cf5ee709e1967131 100644 (file)
@@ -33,8 +33,8 @@ class CRM_Event_Cart_BAO_MerParticipant extends CRM_Event_BAO_Participant {
   public $contribution_id = NULL;
   public $cart = NULL;
 
-  //XXX
   /**
+   * XXX
    * @param null $participant
    */
   public function __construct($participant = NULL) {
index b483498281e476335d5c0f86f45fc52ea57bc94b..a3c4da88f48696b7a7d48a1a11db1d200b470c8f 100644 (file)
@@ -107,8 +107,8 @@ class CRM_Event_Cart_Form_MerParticipant extends CRM_Core_Form {
     return "Participant {$this->participant->get_participant_index()}";
   }
 
-  //XXX poor name
   /**
+   * XXX poor name
    * @param $participant
    *
    * @return CRM_Event_Cart_Form_MerParticipant
index f2a832bf738bd133ee9c3b01f33e58983bb9b06f..9399c0a63ca86ad8313d29a6670b6d3f1c2ec6cc 100644 (file)
@@ -40,8 +40,8 @@ class CRM_Event_Info extends CRM_Core_Component_Info {
   // docs inherited from interface
   protected $keyword = 'event';
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function getInfo() {
@@ -54,8 +54,8 @@ class CRM_Event_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @param bool $getAllUnconditionally
    *
    * @return array
@@ -81,8 +81,8 @@ class CRM_Event_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function getUserDashboardElement() {
@@ -94,8 +94,8 @@ class CRM_Event_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function registerTab() {
@@ -107,8 +107,8 @@ class CRM_Event_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function registerAdvancedSearchPane() {
@@ -118,8 +118,8 @@ class CRM_Event_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function getActivityTypes() {
@@ -131,8 +131,8 @@ class CRM_Event_Info extends CRM_Core_Component_Info {
     return $types;
   }
 
-  // add shortcut to Create New
   /**
+   * add shortcut to Create New
    * @param $shortCuts
    * @param $newCredit
    */
index d664af865a3efec31d5c396c59d3ba307bb37d69..06e33b76094babe22208296ec59a1a79c81a966f 100644 (file)
@@ -59,8 +59,8 @@ class CRM_Financial_BAO_ExportFormat {
     }
   }
 
-  // Override to assemble the appropriate subset of financial data for the specific export format
   /**
+   * Override to assemble the appropriate subset of financial data for the specific export format
    * @param array $exportParams
    *
    * @return mixed
@@ -102,8 +102,8 @@ class CRM_Financial_BAO_ExportFormat {
     return 'txt';
   }
 
-  // Override this if appropriate
   /**
+   * Override this if appropriate
    * @return null
    */
   public function getTemplateFileName() {
index 0176c5af35b00e17b99d83b9d87d370b0f86c9c9..5a8a4620ac804bae3d0d7584b5251192dba47e08 100644 (file)
@@ -40,8 +40,8 @@ class CRM_Grant_Info extends CRM_Core_Component_Info {
   // docs inherited from interface
   protected $keyword = 'grant';
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function getInfo() {
@@ -56,8 +56,8 @@ class CRM_Grant_Info extends CRM_Core_Component_Info {
   }
 
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @param bool $getAllUnconditionally
    *
    * @return array
@@ -70,8 +70,8 @@ class CRM_Grant_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return null
    */
   public function getUserDashboardElement() {
@@ -79,8 +79,8 @@ class CRM_Grant_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return null
    */
   public function getUserDashboardObject() {
@@ -88,8 +88,8 @@ class CRM_Grant_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function registerTab() {
@@ -100,8 +100,8 @@ class CRM_Grant_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function registerAdvancedSearchPane() {
@@ -111,16 +111,16 @@ class CRM_Grant_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return null
    */
   public function getActivityTypes() {
     return NULL;
   }
 
-  // add shortcut to Create New
   /**
+   * add shortcut to Create New
    * @param $shortCuts
    */
   public function creatNewShortcut(&$shortCuts) {
index 5035d67e7acde856d75d8f8d279dff98c1b78372..0c0b959a72bfd2290c9b7e6d4988df06c276a98b 100644 (file)
@@ -109,9 +109,9 @@ class CRM_Mailing_BAO_Mailing extends CRM_Mailing_DAO_Mailing {
     return $eq->N;
   }
 
-  // note that $job_id is used only as a variable in the temp table construction
-  // and does not play a role in the queries generated
   /**
+   * note that $job_id is used only as a variable in the temp table construction
+   * and does not play a role in the queries generated
    * @param int $job_id
    *   (misnomer) a nonce value used to name temporary tables.
    * @param int $mailing_id
index 896808feeeefc105600befe2346ba67484641f18..9df531b71e8ba211a4a1494cb29869e01ab38212 100644 (file)
@@ -221,9 +221,9 @@ class CRM_Mailing_BAO_MailingJob extends CRM_Mailing_DAO_MailingJob {
     }
   }
 
-  // post process to determine if the parent job
-  // as well as the mailing is complete after the run
   /**
+   * post process to determine if the parent job
+   * as well as the mailing is complete after the run
    * @param null $mode
    */
   public static function runJobs_post($mode = NULL) {
@@ -293,8 +293,8 @@ class CRM_Mailing_BAO_MailingJob extends CRM_Mailing_DAO_MailingJob {
   }
 
 
-  // before we run jobs, we need to split the jobs
   /**
+   * before we run jobs, we need to split the jobs
    * @param int $offset
    * @param null $mode
    */
@@ -380,9 +380,9 @@ class CRM_Mailing_BAO_MailingJob extends CRM_Mailing_DAO_MailingJob {
     }
   }
 
-  // Split the parent job into n number of child job based on an offset
-  // If null or 0 , we create only one child job
   /**
+   * Split the parent job into n number of child job based on an offset
+   * If null or 0 , we create only one child job
    * @param int $offset
    */
   public function split_job($offset = 200) {
index f3709988c0f799be919f8ab20efae043845ff11f..03196ea84d5d5339a368447ced654c7cd58cffe7 100644 (file)
@@ -41,8 +41,8 @@ class CRM_Mailing_Info extends CRM_Core_Component_Info {
   protected $keyword = 'mailing';
 
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function getInfo() {
@@ -177,8 +177,8 @@ class CRM_Mailing_Info extends CRM_Core_Component_Info {
     ) ? TRUE : FALSE;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @param bool $getAllUnconditionally
    *
    * @return array
@@ -201,8 +201,8 @@ class CRM_Mailing_Info extends CRM_Core_Component_Info {
   }
 
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return null
    */
   public function getUserDashboardElement() {
@@ -218,8 +218,8 @@ class CRM_Mailing_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function registerTab() {
@@ -231,8 +231,8 @@ class CRM_Mailing_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return array
    */
   public function registerAdvancedSearchPane() {
@@ -242,16 +242,16 @@ class CRM_Mailing_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * @return null
    */
   public function getActivityTypes() {
     return NULL;
   }
 
-  // add shortcut to Create New
   /**
+   * add shortcut to Create New
    * @param $shortCuts
    */
   public function creatNewShortcut(&$shortCuts) {
index 32672bf103f51454a20594d74c0c50a797010cab..b362c4ecd33bb0a7592e167f2b902a517e42f09e 100644 (file)
@@ -40,8 +40,8 @@ class CRM_Member_Info extends CRM_Core_Component_Info {
   // docs inherited from interface
   protected $keyword = 'member';
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides base information about the component.
    * Needs to be implemented in component's information
    * class.
@@ -63,8 +63,8 @@ class CRM_Member_Info extends CRM_Core_Component_Info {
   }
 
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides permissions that are used by component.
    * Needs to be implemented in component's information
    * class.
@@ -90,8 +90,8 @@ class CRM_Member_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about user dashboard element
    * offered by this component.
    *
@@ -114,8 +114,8 @@ class CRM_Member_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about user dashboard element
    * offered by this component.
    *
@@ -134,8 +134,8 @@ class CRM_Member_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about advanced search pane
    * offered by this component.
    *
@@ -153,8 +153,8 @@ class CRM_Member_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides potential activity types that this
    * component might want to register in activity history.
    * Needs to be implemented in component's information
@@ -170,8 +170,8 @@ class CRM_Member_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // add shortcut to Create New
   /**
+   * add shortcut to Create New
    * @param $shortCuts
    * @param $newCredit
    */
index 4944b06e81ae960be694515bc7586dee57be7c24..0dcee85e39012eeef252f39939f0637898639bd4 100644 (file)
@@ -389,8 +389,8 @@ class CRM_PCP_Page_PCP extends CRM_Core_Page_Basic {
     return 'civicrm/admin/pcp';
   }
 
-  //@TODO this function changed, debug this at runtime
   /**
+   * @TODO this function changed, debug this at runtime
    * @param $whereClause
    * @param array $whereParams
    */
index 6edfd588ef119571d50a64c8b3a68f9ce573d531..caa5f449418f75e09cf72149cfdc7bd62d3f01fb 100644 (file)
@@ -59,8 +59,8 @@ class CRM_Pledge_Info extends CRM_Core_Component_Info {
   }
 
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides permissions that are used by component.
    * Needs to be implemented in component's information
    * class.
@@ -86,8 +86,8 @@ class CRM_Pledge_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about user dashboard element
    * offered by this component.
    *
@@ -108,8 +108,8 @@ class CRM_Pledge_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about user dashboard element
    * offered by this component.
    *
@@ -128,8 +128,8 @@ class CRM_Pledge_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about advanced search pane
    * offered by this component.
    *
@@ -147,8 +147,8 @@ class CRM_Pledge_Info extends CRM_Core_Component_Info {
     );
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides potential activity types that this
    * component might want to register in activity history.
    * Needs to be implemented in component's information
@@ -164,8 +164,8 @@ class CRM_Pledge_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // add shortcut to Create New
   /**
+   * add shortcut to Create New
    * @param $shortCuts
    */
   public function creatNewShortcut(&$shortCuts) {
index 70b027e27f427d4a791092b66255be4ce55bb037..881730e60896e7f9f78459d2e9388c6a39aa4571 100644 (file)
@@ -1213,10 +1213,10 @@ class CRM_Report_Form extends CRM_Core_Form {
     }
   }
 
-  // a formrule function to ensure that fields selected in group_by
-  // (if any) should only be the ones present in display/select fields criteria;
-  // note: works if and only if any custom field selected in group_by.
   /**
+   * a formrule function to ensure that fields selected in group_by
+   * (if any) should only be the ones present in display/select fields criteria;
+   * note: works if and only if any custom field selected in group_by.
    * @param $fields
    * @param array $ignoreFields
    *
@@ -1254,9 +1254,9 @@ class CRM_Report_Form extends CRM_Core_Form {
     return $errors;
   }
 
-  // Note: $fieldName param allows inheriting class to build operationPairs
-  // specific to a field.
   /**
+   * Note: $fieldName param allows inheriting class to build operationPairs
+   * specific to a field.
    * @param string $type
    * @param null $fieldName
    *
@@ -2640,8 +2640,8 @@ WHERE cg.extends IN ('" . implode("','", $this->_customGroupExtends) . "') AND
     $this->assign('statistics', $this->statistics($rows));
   }
 
-  // override this method to build your own statistics
   /**
+   * override this method to build your own statistics
    * @param $rows
    *
    * @return array
index 6d3b80d7f2520a5df10564ab1b46c1a07585496f..842841c73c741dd2d28fdaa018f01d7709bd7783 100644 (file)
@@ -744,16 +744,16 @@ class CRM_Report_Form_Contact_Detail extends CRM_Report_Form {
     return $statistics;
   }
 
-  //Override to set limit is 10
   /**
+   * Override to set limit is 10
    * @param int $rowCount
    */
   public function limit($rowCount = self::ROW_COUNT_LIMIT) {
     parent::limit($rowCount);
   }
 
-  //Override to set pager with limit is 10
   /**
+   * Override to set pager with limit is 10
    * @param int $rowCount
    */
   public function setPager($rowCount = self::ROW_COUNT_LIMIT) {
index 02f6bd88e9fd40dc0f59b1d45bd2f76f94ae0057..0f43b3b40f16d317fd29beaa76850e0e8ffacfba 100644 (file)
@@ -419,16 +419,16 @@ class CRM_Report_Form_Contribute_History extends CRM_Report_Form {
     $this->_groupBy = "GROUP BY {$this->_aliases['civicrm_contribution']}.contact_id, YEAR({$this->_aliases['civicrm_contribution']}.receive_date)";
   }
 
-  //Override to set limit is 10
   /**
+   * Override to set limit is 10
    * @param int $rowCount
    */
   public function limit($rowCount = self::ROW_COUNT_LIMIT) {
     parent::limit($rowCount);
   }
 
-  //Override to set pager with limit is 10
   /**
+   * Override to set pager with limit is 10
    * @param int $rowCount
    */
   public function setPager($rowCount = self::ROW_COUNT_LIMIT) {
@@ -710,8 +710,8 @@ class CRM_Report_Form_Contribute_History extends CRM_Report_Form {
     return array($relationshipRows, $relatedContactIds);
   }
 
-  // Override "This Year" $op options
   /**
+   * Override "This Year" $op options
    * @param string $type
    * @param null $fieldName
    *
index 981721d11893b7bb296d0f49a1984a40df536883..75ca55c5a0acafb7931ac86ca279abf5ff66b768 100644 (file)
@@ -499,8 +499,8 @@ class CRM_Report_Form_Contribute_Lybunt extends CRM_Report_Form {
     }
   }
 
-  // Override "This Year" $op options
   /**
+   * Override "This Year" $op options
    * @param string $type
    * @param null $fieldName
    *
index 744549750bcea6cb19c750079337894151cfda6e..67f6f21f215485e6b9e0ea30dd5defff251b067b 100644 (file)
@@ -516,8 +516,8 @@ class CRM_Report_Form_Contribute_Sybunt extends CRM_Report_Form {
     }
   }
 
-  // Override "This Year" $op options
   /**
+   * Override "This Year" $op options
    * @param string $type
    * @param null $fieldName
    *
index b0d87a15a2ba6dbedbaa1b5bc7372661089c313e..960d5ed3cc718ff5f65b23476dbbe936bf89de0a 100644 (file)
@@ -270,8 +270,8 @@ class CRM_Report_Form_Event_ParticipantListCount extends CRM_Report_Form_Event {
     parent::preProcess();
   }
 
-  //Add The statistics
   /**
+   * Add The statistics
    * @param $rows
    *
    * @return array
index f2fbc92d6e9f660ee1679c817c5cf27526f0a58c..e649777b00ddd6880ea1367c6514ba973141b21d 100644 (file)
@@ -181,8 +181,8 @@ class CRM_Report_Form_Event_Summary extends CRM_Report_Form_Event {
     $this->_groupBy = " GROUP BY {$this->_aliases['civicrm_event']}.id";
   }
 
-  //get participants information for events
   /**
+   * get participants information for events
    * @return array
    */
   public function participantInfo() {
index 5d461d9957f966ce1d67a7170d7ef0fb226fb426..9354f5e82f50839a8f5c6939659adc95e9675e4e 100644 (file)
@@ -40,8 +40,8 @@ class CRM_Report_Info extends CRM_Core_Component_Info {
   // docs inherited from interface
   protected $keyword = 'report';
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides base information about the component.
    * Needs to be implemented in component's information
    * class.
@@ -63,8 +63,8 @@ class CRM_Report_Info extends CRM_Core_Component_Info {
   }
 
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides permissions that are used by component.
    * Needs to be implemented in component's information
    * class.
@@ -87,8 +87,8 @@ class CRM_Report_Info extends CRM_Core_Component_Info {
   }
 
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about user dashboard element
    * offered by this component.
    *
@@ -118,8 +118,8 @@ class CRM_Report_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about user dashboard element
    * offered by this component.
    *
@@ -135,8 +135,8 @@ class CRM_Report_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides information about advanced search pane
    * offered by this component.
    *
@@ -152,8 +152,8 @@ class CRM_Report_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // docs inherited from interface
   /**
+   * docs inherited from interface
    * Provides potential activity types that this
    * component might want to register in activity history.
    * Needs to be implemented in component's information
@@ -169,8 +169,8 @@ class CRM_Report_Info extends CRM_Core_Component_Info {
     return NULL;
   }
 
-  // add shortcut to Create New
   /**
+   * add shortcut to Create New
    * @param $shortCuts
    */
   public function creatNewShortcut(&$shortCuts) {
index 62665b4dbfb287fd2882caececcd2cc57117a2d8..17cbbce44e8df5b673d0a93ee8bad68d3dd38733 100644 (file)
@@ -232,8 +232,8 @@ class CRM_Report_Utils_Get {
     }
   }
 
-  //unset default filters
   /**
+   * unset default filters
    * @param $defaults
    */
   public static function unsetFilters(&$defaults) {
index 93cdac329a993f1c9447cf44d64490d9db677ad5..a0a2bf9971e85f34c540c2ea91206a7553f43311 100644 (file)
@@ -155,8 +155,8 @@ WHERE  TRIM(BOTH '/' FROM CONCAT(report_id, '/', name)) = %1";
     }
   }
 
-  // get instance count for a template
   /**
+   * get instance count for a template
    * @param $optionVal
    *
    * @return int|null|string
index b57ede35a9576b2354841cd88074584f9906e63f..db8dfa79ae6d6eb2fa2d7f9a52c7b1aeda25a08e 100644 (file)
@@ -419,8 +419,8 @@ ADD CONSTRAINT `FK_civicrm_financial_item_contact_id` FOREIGN KEY (`contact_id`)
     $this->addTask('Update Line Item Data', 'updateLineItemData', $rev);
   }
 
-  //CRM-11636
   /**
+   * CRM-11636
    * @return bool
    */
   public function assignFinancialTypeToPriceRecords() {
index 3ecec2efd49bcab8725802839ae5b838bcfaebcb..4cda5c0e1ce20d879dff84268f807baf61d89c7d 100644 (file)
@@ -298,9 +298,9 @@ SELECT *
     $this->table($contactIDs, 'civicrm_group_contact', $fields, 'contact_id', NULL);
   }
 
-  // TODO - support group inheritance
-  // Parent child group ids are encoded in a text string
   /**
+   * TODO - support group inheritance
+   * Parent child group ids are encoded in a text string
    * @param $contactIDs
    */
   public function group(&$contactIDs) {
@@ -329,8 +329,8 @@ WHERE  contact_id IN ( $ids )
     $this->savedSearch($groupIDs);
   }
 
-  // TODO - support search builder and custom saved searches
   /**
+   * TODO - support search builder and custom saved searches
    * @param $groupIDs
    */
   public function savedSearch(&$groupIDs) {
index 5ecf2ae45da1cbe0dc8ae32ee987e82c1b472625..12723bce096fbdcd1b43348264da9aaf0f036124 100644 (file)
@@ -73,8 +73,8 @@ class CRM_Utils_REST {
     return self::simple(array('message' => "PONG: $key"));
   }
 
-  // Generates values needed for error messages
   /**
+   * Generates values needed for error messages
    * @param string $message
    *
    * @return array
@@ -87,8 +87,8 @@ class CRM_Utils_REST {
     return $values;
   }
 
-  // Generates values needed for non-error responses.
   /**
+   * Generates values needed for non-error responses.
    * @param array $params
    *
    * @return array
index 0a737d1309290b9ca4783d1c086e5fa2e598f201..fbd45cedd254510a5b843fe515bec278722dfaaa 100644 (file)
@@ -538,10 +538,10 @@ class CRM_Utils_Rule {
     return TRUE;
   }
 
-  // allow between 4-6 digits as postal code since india needs 6 and US needs 5 (or
-  // if u disregard the first 0, 4 (thanx excel!)
-  // FIXME: we need to figure out how to localize such rules
   /**
+   * allow between 4-6 digits as postal code since india needs 6 and US needs 5 (or
+   * if u disregard the first 0, 4 (thanx excel!)
+   * FIXME: we need to figure out how to localize such rules
    * @param $value
    *
    * @return bool
index 1ee7914cbf64cd30549598b861568ef28210ac02..7f0186b88f10be4119bef6ec1a9e2c34c58dc468 100644 (file)
@@ -47,8 +47,8 @@ class API_Exception extends Exception {
     $this->extraParams = $extraParams + array('error_code' => $error_code);
   }
 
-  // custom string representation of object
   /**
+   * custom string representation of object
    * @return string
    */
   public function __toString() {
@@ -101,8 +101,8 @@ class CiviCRM_API3_Exception extends Exception {
     $this->extraParams = $extraParams + array('error_code' => $error_code);
   }
 
-  // custom string representation of object
   /**
+   * custom string representation of object
    * @return string
    */
   public function __toString() {
index 0b2efc55e7e7a2656645a4dd927e1ad98fc207a2..abd5f28d6db776a9edcbb3dbc7f1d7c0d58da431 100644 (file)
@@ -59,8 +59,8 @@ class CRM_Event_BAO_AdditionalPaymentTest extends CiviUnitTestCase {
     );
   }
 
-  // helper function to record participant with paid contribution
   /**
+   * helper function to record participant with paid contribution
    * @param $feeTotal
    * @param $actualPaidAmt
    *
index c8e8556c0d8a6c021bb1673c3ee1ed35c7a1b248..e926a1194e332acb031cabd6275aa648ddddb206 100644 (file)
@@ -1631,8 +1631,8 @@ class CiviSeleniumTestCase extends PHPUnit_Extensions_SeleniumTestCase {
     return CiviDBAssert::assertDBState($this, $daoName, $id, $match, $delete);
   }
 
-  // Request a record from the DB by seachColumn+searchValue. Success if a record is found.
   /**
+   * Request a record from the DB by seachColumn+searchValue. Success if a record is found.
    * @param string $daoName
    * @param $searchValue
    * @param $returnColumn
@@ -1649,8 +1649,8 @@ class CiviSeleniumTestCase extends PHPUnit_Extensions_SeleniumTestCase {
     return CiviDBAssert::assertDBNotNull($this, $daoName, $searchValue, $returnColumn, $searchColumn, $message);
   }
 
-  // Request a record from the DB by seachColumn+searchValue. Success if returnColumn value is NULL.
   /**
+   * Request a record from the DB by seachColumn+searchValue. Success if returnColumn value is NULL.
    * @param string $daoName
    * @param $searchValue
    * @param $returnColumn
@@ -1665,8 +1665,8 @@ class CiviSeleniumTestCase extends PHPUnit_Extensions_SeleniumTestCase {
     return CiviDBAssert::assertDBNull($this, $daoName, $searchValue, $returnColumn, $searchColumn, $message);
   }
 
-  // Request a record from the DB by id. Success if row not found.
   /**
+   * Request a record from the DB by id. Success if row not found.
    * @param string $daoName
    * @param int $id
    * @param $message
@@ -1679,8 +1679,8 @@ class CiviSeleniumTestCase extends PHPUnit_Extensions_SeleniumTestCase {
     return CiviDBAssert::assertDBRowNotExist($this, $daoName, $id, $message);
   }
 
-  // Compare a single column value in a retrieved DB record to an expected value
   /**
+   * Compare a single column value in a retrieved DB record to an expected value
    * @param string $daoName
    * @param $searchValue
    * @param $returnColumn
@@ -1701,8 +1701,8 @@ class CiviSeleniumTestCase extends PHPUnit_Extensions_SeleniumTestCase {
     );
   }
 
-  // Compare all values in a single retrieved DB record to an array of expected values
   /**
+   * Compare all values in a single retrieved DB record to an array of expected values
    * @param string $daoName
    * @param array $searchParams
    * @param $expectedValues
index b57671daee91c6ee3ee50baa3ad7b9efc147fee2..cde898f8a91bbe57bd5573040b17411848b6bd56 100755 (executable)
@@ -600,8 +600,8 @@ class CiviUnitTestCase extends PHPUnit_Extensions_Database_TestCase {
     }
   }
 
-  // Request a record from the DB by seachColumn+searchValue. Success if a record is found.
   /**
+   * Request a record from the DB by seachColumn+searchValue. Success if a record is found.
    * @param string $daoName
    * @param $searchValue
    * @param $returnColumn
@@ -621,8 +621,8 @@ class CiviUnitTestCase extends PHPUnit_Extensions_Database_TestCase {
     return $value;
   }
 
-  // Request a record from the DB by seachColumn+searchValue. Success if returnColumn value is NULL.
   /**
+   * Request a record from the DB by seachColumn+searchValue. Success if returnColumn value is NULL.
    * @param string $daoName
    * @param $searchValue
    * @param $returnColumn
@@ -634,8 +634,8 @@ class CiviUnitTestCase extends PHPUnit_Extensions_Database_TestCase {
     $this->assertNull($value, $message);
   }
 
-  // Request a record from the DB by id. Success if row not found.
   /**
+   * Request a record from the DB by id. Success if row not found.
    * @param string $daoName
    * @param int $id
    * @param null $message
@@ -646,8 +646,8 @@ class CiviUnitTestCase extends PHPUnit_Extensions_Database_TestCase {
     $this->assertNull($value, $message);
   }
 
-  // Request a record from the DB by id. Success if row not found.
   /**
+   * Request a record from the DB by id. Success if row not found.
    * @param string $daoName
    * @param int $id
    * @param null $message
@@ -658,8 +658,8 @@ class CiviUnitTestCase extends PHPUnit_Extensions_Database_TestCase {
     $this->assertEquals($id, $value, $message);
   }
 
-  // Compare a single column value in a retrieved DB record to an expected value
   /**
+   * Compare a single column value in a retrieved DB record to an expected value
    * @param string $daoName
    * @param $searchValue
    * @param $returnColumn
@@ -675,8 +675,8 @@ class CiviUnitTestCase extends PHPUnit_Extensions_Database_TestCase {
     $this->assertEquals($value, $expectedValue, $message);
   }
 
-  // Compare all values in a single retrieved DB record to an array of expected values
   /**
+   * Compare all values in a single retrieved DB record to an array of expected values
    * @param string $daoName
    * @param array $searchParams
    * @param $expectedValues
index 2dd7d4a84dda84cdce94bcc7c81a5c1779bd3eca..3f25895f60d0ce6577b151d583aef854b0f0a510 100644 (file)
@@ -118,8 +118,8 @@ class WebTest_Admin_MoveCustomDataTest extends CiviSeleniumTestCase {
     $this->assertElementContainsText("css=div." . $destination['name'], $fields['values'][$field_to_move]['label'], "Moved value does not display in the new fieldset on the contact record");
   }
 
-  //moves a field from one field to another
   /**
+   * moves a field from one field to another
    * @param $field_to_move
    * @param int $from_group_id
    * @param int $to_group_id
@@ -148,8 +148,8 @@ class WebTest_Admin_MoveCustomDataTest extends CiviSeleniumTestCase {
     $this->assertTrue($this->isElementPresent("CustomField-" . $field_to_move), "The moved custom field does not display on the new fieldset page");
   }
 
-  //create a contact and return the contact id
   /**
+   * create a contact and return the contact id
    * @param string $firstName
    * @param string $lastName
    *
@@ -165,8 +165,8 @@ class WebTest_Admin_MoveCustomDataTest extends CiviSeleniumTestCase {
     return $cid;
   }
 
-  //Get all custom field values for a given contact and custom group id using the api
   /**
+   * Get all custom field values for a given contact and custom group id using the api
    * @param int $contact_id
    * @param int $group_id
    * @param bool $reset_cache
@@ -208,8 +208,8 @@ class WebTest_Admin_MoveCustomDataTest extends CiviSeleniumTestCase {
     return $results;
   }
 
-  //creates a new custom group and fields in that group, and returns the group Id
   /**
+   * creates a new custom group and fields in that group, and returns the group Id
    * @param $prefix
    *
    * @return null
@@ -224,8 +224,8 @@ class WebTest_Admin_MoveCustomDataTest extends CiviSeleniumTestCase {
     return $group_id;
   }
 
-  //Creates a custom field group for a specific entity type and returns the custom group Id
   /**
+   * Creates a custom field group for a specific entity type and returns the custom group Id
    * @param string $prefix
    * @param string $entity
    *
@@ -253,9 +253,9 @@ class WebTest_Admin_MoveCustomDataTest extends CiviSeleniumTestCase {
     return $this->urlArg('gid');
   }
 
-  //Adds a new custom field to a specfied custom field group, using the given
-  //datatype and widget.
   /**
+   * Adds a new custom field to a specfied custom field group, using the given
+   * datatype and widget.
    * @param int $group_id
    * @param string $type
    * @param string $widget
@@ -411,8 +411,8 @@ class WebTest_Admin_MoveCustomDataTest extends CiviSeleniumTestCase {
     return $results['id'];
   }
 
-  //Populates $count options for a custom field on the add custom field page
   /**
+   * Populates $count options for a custom field on the add custom field page
    * @param int $count
    * @param string $prefix
    * @param array $values
@@ -428,8 +428,8 @@ class WebTest_Admin_MoveCustomDataTest extends CiviSeleniumTestCase {
     }
   }
 
-  //randomly generates data for a specific custom field
   /**
+   * randomly generates data for a specific custom field
    * @param int $contact_id
    * @param int $group_id
    */
index 3a470752fe1f3becc0385cad90222324589521b8..4443d89b56e5acf915f2d8a9609d8241a74f2c10 100644 (file)
@@ -214,8 +214,8 @@ class WebTest_Contact_AdvancedSearchTest extends CiviSeleniumTestCase {
     }
   }
 
-  //function to check match for sumbit Advance Search
   /**
+   * function to check match for sumbit Advance Search
    * @param string $firstName
    */
   public function submitSearch($firstName) {
@@ -258,8 +258,8 @@ class WebTest_Contact_AdvancedSearchTest extends CiviSeleniumTestCase {
     $this->assertElementNotContainsText("xpath=//div[@class='crm-search-results']//table/tbody/tr[1]/td[6]", $stateBeforeSort);
   }
 
-  // function to fill basic search detail
   /**
+   * function to fill basic search detail
    * @param string $firstName
    * @param string $groupName
    * @param $tagName
@@ -285,8 +285,8 @@ class WebTest_Contact_AdvancedSearchTest extends CiviSeleniumTestCase {
     $this->check("preferred_communication_method[2]");
   }
 
-  // function to fill address search block values in advance search
   /**
+   * function to fill address search block values in advance search
    * @param $firstName
    */
   public function addAddressSearchDetail($firstName) {
@@ -306,8 +306,8 @@ class WebTest_Contact_AdvancedSearchTest extends CiviSeleniumTestCase {
     $this->select2("state_province", "Alaska", TRUE);
   }
 
-  // function to fill activity search block in advance search
   /**
+   * function to fill activity search block in advance search
    * @param $firstName
    */
   public function addActivitySearchDetail($firstName) {
@@ -342,8 +342,8 @@ class WebTest_Contact_AdvancedSearchTest extends CiviSeleniumTestCase {
     $this->check("civicrm_gender_Male_2");
   }
 
-  //function to fill contribution search details
   /**
+   * function to fill contribution search details
    * @param $firstName
    */
   public function addContributionSearchDetail($firstName) {
@@ -384,8 +384,8 @@ class WebTest_Contact_AdvancedSearchTest extends CiviSeleniumTestCase {
     $this->type("participant_fee_amount_high", "150");
   }
 
-  // function to fill member search details
   /**
+   * function to fill member search details
    * @param $firstName
    */
   public function addMemberSearchDetail($firstName) {
@@ -411,8 +411,8 @@ class WebTest_Contact_AdvancedSearchTest extends CiviSeleniumTestCase {
     $this->webtestFillDate("member_end_date_high", "+2 year");
   }
 
-  // function to fill member search details
   /**
+   * function to fill member search details
    * @param $firstName
    */
   public function addPledgeSearchDetail($firstName) {
@@ -439,8 +439,8 @@ class WebTest_Contact_AdvancedSearchTest extends CiviSeleniumTestCase {
     $this->select("pledge_financial_type_id", "Donation");
   }
 
-  // function to create contact with details (contact details, address, Constituent information ...)
   /**
+   * function to create contact with details (contact details, address, Constituent information ...)
    * @param null $firstName
    */
   public function createDetailContact($firstName = NULL) {
index 6f6fdb6b2e108370ba969cbe47c81077c457b192..815c946134fd4bb69573cb813f171b50ff4f4277 100644 (file)
@@ -26,9 +26,9 @@
 
 require_once 'CiviTest/CiviSeleniumTestCase.php';
 
-//Tests for the ability to add a CMS user from a contact's record
-//See http://issues.civicrm.org/jira/browse/CRM-8723
 /**
+ * Tests for the ability to add a CMS user from a contact's record
+ * See http://issues.civicrm.org/jira/browse/CRM-8723
  * Class WebTest_Contact_CreateCmsUserFromContactTest
  */
 class WebTest_Contact_CreateCmsUserFromContactTest extends CiviSeleniumTestCase {
index a6aa2a8107ce6467b45df4d20d24d0c997b625b1..d5686d86af56d82d24f6fef52aa77266ca0799b2 100644 (file)
@@ -71,8 +71,8 @@ class WebTest_Contact_SearchBuilderTest extends CiviSeleniumTestCase {
     $this->_searchBuilder("Postal Code", "100[0-9]", $sortName, "RLIKE");
   }
 
-  // function to create contact with details (contact details, address, Constituent information ...)
   /**
+   * function to create contact with details (contact details, address, Constituent information ...)
    * @param null $firstName
    */
   public function createDetailContact($firstName = NULL) {
index 7026dd9f682159980b588f299e962698ed3446b0..3f49498757790b260d19abcfe9a405881fb9085c 100644 (file)
@@ -308,8 +308,8 @@ class WebTest_Contribute_OfflineContributionTest extends CiviSeleniumTestCase {
     $this->_verifyAmounts($checkScenario5);
   }
 
-  //common function for doing offline contribution
   /**
+   * common function for doing offline contribution
    * @param array $params
    * @param string $firstName
    * @param string $lastName
@@ -364,8 +364,8 @@ class WebTest_Contribute_OfflineContributionTest extends CiviSeleniumTestCase {
     $this->assertTrue($this->isTextPresent("The contribution record has been processed."), "Status message didn't show up after saving!");
   }
 
-  //common function for verifing total_amount, and non_deductible_amount
   /**
+   * common function for verifing total_amount, and non_deductible_amount
    * @param $verifyData
    */
   public function _verifyAmounts($verifyData) {
index d21658532d3fb89bb65ee08698991b47d5a87e99..9fa85523fceea09082f0229f23d98351b79a01ec 100644 (file)
 
 require_once 'ReleaseTestCase.php';
 
-// name of the class doesn't end with Test on purpose - this way this
-// webtest is not picked up by the suite, since it needs to run
-// on specially prepare sandbox
-// more details: http://wiki.civicrm.org/confluence/display/CRMDOC/Release+testing+script
 /**
+ * name of the class doesn't end with Test on purpose - this way this
+ * webtest is not picked up by the suite, since it needs to run
+ * on specially prepare sandbox
+ * more details: http://wiki.civicrm.org/confluence/display/CRMDOC/Release+testing+script
  * Class WebTest_Release_InstallScript
  */
 class WebTest_Release_InstallScript extends WebTest_Release_ReleaseTestCase {
index 8a16a97e409cb14b86334247731da3d260f1897e..034fcfb51cbfc8386e0f0f2fdf06df4817b311c6 100644 (file)
 
 require_once 'CiviTest/CiviSeleniumTestCase.php';
 
-// name of the class doesn't end with Test on purpose - this way this
-// webtest is not picked up by the suite, since it needs to run
-// on specially prepare sandbox
-// more details: http://wiki.civicrm.org/confluence/display/CRMDOC/Release+testing+script
 /**
+ * name of the class doesn't end with Test on purpose - this way this
+ * webtest is not picked up by the suite, since it needs to run
+ * on specially prepare sandbox
+ * more details: http://wiki.civicrm.org/confluence/display/CRMDOC/Release+testing+script
  * Class WebTest_Release_ReleaseTestCase
  */
 class WebTest_Release_ReleaseTestCase extends CiviSeleniumTestCase {
index eea1b14867a1276183667eff34242b23f5dbad59..b91531a6f462e26bd8e5758c2ea1c8bb0fe72eb8 100644 (file)
 
 require_once 'ReleaseTestCase.php';
 
-// name of the class doesn't end with Test on purpose - this way this
-// webtest is not picked up by the suite, since it needs to run
-// on specially prepare sandbox
-// more details: http://wiki.civicrm.org/confluence/display/CRMDOC/Release+testing+script
 /**
+ * name of the class doesn't end with Test on purpose - this way this
+ * webtest is not picked up by the suite, since it needs to run
+ * on specially prepare sandbox
+ * more details: http://wiki.civicrm.org/confluence/display/CRMDOC/Release+testing+script
  * Class WebTest_Release_UpgradeScript
  */
 class WebTest_Release_UpgradeScript extends WebTest_Release_ReleaseTestCase {