INFRA-132 - Whitespace fixes in docbloks
authorColeman Watts <coleman@civicrm.org>
Sat, 10 Jan 2015 03:03:14 +0000 (22:03 -0500)
committerColeman Watts <coleman@civicrm.org>
Sat, 10 Jan 2015 03:03:14 +0000 (22:03 -0500)
37 files changed:
CRM/Activity/BAO/ICalendar.php
CRM/Activity/Selector/Activity.php
CRM/Activity/Selector/Search.php
CRM/Campaign/BAO/Petition.php
CRM/Campaign/Selector/Search.php
CRM/Case/Selector/Search.php
CRM/Contact/BAO/Query.php
CRM/Contact/BAO/Relationship.php
CRM/Contact/Selector/Custom.php
CRM/Contribute/Selector/Search.php
CRM/Core/DAO.php
CRM/Core/QuickForm/Action.php
CRM/Core/QuickForm/Action/Cancel.php
CRM/Core/QuickForm/Action/Display.php
CRM/Core/QuickForm/Action/Done.php
CRM/Core/QuickForm/Action/Jump.php
CRM/Core/QuickForm/Action/Next.php
CRM/Core/QuickForm/Action/Process.php
CRM/Core/QuickForm/Action/Refresh.php
CRM/Core/QuickForm/Action/Reload.php
CRM/Core/QuickForm/Action/Submit.php
CRM/Core/QuickForm/Action/Upload.php
CRM/Core/Selector/Controller.php
CRM/Core/StateMachine.php
CRM/Event/Selector/Search.php
CRM/Extension/Manager/Payment.php
CRM/Grant/Selector/Search.php
CRM/Mailing/Selector/Browse.php
CRM/Mailing/Selector/Event.php
CRM/Mailing/Selector/Search.php
CRM/Member/BAO/MembershipStatus.php
CRM/Member/Selector/Search.php
CRM/Pledge/Selector/Search.php
CRM/Profile/Selector/Listings.php
CRM/Upgrade/Form.php
CRM/Utils/Sort.php
api/v3/CustomField.php

index 671bd64d98c0fc27ef3cfdca150795bd71721646..d81317c0276f1b8702203f59237da70b465b8088 100644 (file)
@@ -51,7 +51,7 @@ class CRM_Activity_BAO_ICalendar {
    *   Reference to an activity object.
    *
    * @return \CRM_Activity_BAO_ICalendar
-  @access public
+   * @access public
    */
   public function __construct(&$act) {
     $this->activity = $act;
@@ -65,8 +65,8 @@ class CRM_Activity_BAO_ICalendar {
    * @param array $contacts
    *   Array of contacts (attendees).
    *
-   * @return string
-   *   Array index of the added attachment in the $attachments array, or else NULL.
+   * @return string|null
+   *   Array index of the added attachment in the $attachments array, else NULL.
    */
   public function addAttachment(&$attachments, $contacts) {
     // Check preferences setting
@@ -105,14 +105,17 @@ class CRM_Activity_BAO_ICalendar {
     return NULL;
   }
 
+  /**
+   * Remove temp file
+   */
   public function cleanup() {
     if (!empty ($this->icsfile)) {
       @unlink($this->icsfile);
     }
   }
 
-  // TODO: Is there a better way to do this?
   /**
+   * TODO: Is there a better way to do this?
    * @return string
    */
   private function getPrimaryEmail() {
index ddad477fa071b09ca6bcffaa0710bdee5dd46a58..ebcccca1042b16c6ac8ab70720ea32e2397f31f3 100644 (file)
@@ -75,7 +75,7 @@ class CRM_Activity_Selector_Activity extends CRM_Core_Selector_Base implements C
    * @param null $activityTypeIDs
    *
    * @return \CRM_Activity_Selector_Activity
-  @access public
+   * @access public
    */
   function __construct(
     $contactId,
index 2fb16fd79b9438fec90a265cc74be64ca7f71f7c..1cc43cf9a83b60b3e817525ab614fc8567011119 100644 (file)
@@ -155,7 +155,7 @@ class CRM_Activity_Selector_Search extends CRM_Core_Selector_Base implements CRM
    * @param null $compContext
    *
    * @return \CRM_Activity_Selector_Search
-  @access public
+   * @access public
    */
   function __construct(
     &$queryParams,
index 637f07e69cb501069dab6a588b2652ff97d3f50d..23072c0725ef69b48301f87782e1d839bf268a55 100644 (file)
@@ -543,7 +543,7 @@ AND         tag_id = ( SELECT id FROM civicrm_tag WHERE name = %2 )";
    *
    * @throws Exception
    * @return void
-  @access public
+   * @access public
    * @static
    */
   public static function sendEmail($params, $sendEmailMode) {
index 7806b61269efa49021265db06b9495f0c13fc4ac..90d2be1a63dcdcea492d0ccf64146f06b98b1334 100755 (executable)
@@ -147,7 +147,7 @@ class CRM_Campaign_Selector_Search extends CRM_Core_Selector_Base implements CRM
    * @param string $context
    *
    * @return \CRM_Campaign_Selector_Search
-  @access public
+   * @access public
    */
   function __construct(
     &$queryParams,
index e0550729aa8e56add418af85e8646897a9130512..0886e09556d54113c94e952f8dfe348da841b19d 100644 (file)
@@ -143,7 +143,7 @@ class CRM_Case_Selector_Search extends CRM_Core_Selector_Base {
    * @param string $context
    *
    * @return \CRM_Case_Selector_Search
-  @access public
+   * @access public
    */
   function __construct(
     &$queryParams,
index c5a9cb07fccbc8c36bc317f9a4a381e0e717a94c..8933683827fa7a3fb7ddf3c3472e6a32eb1e02c9 100644 (file)
@@ -416,7 +416,7 @@ class CRM_Contact_BAO_Query {
    * @param string $operator
    *
    * @return \CRM_Contact_BAO_Query
-  @access public
+   * @access public
    */
   function __construct(
     $params = NULL, $returnProperties = NULL, $fields = NULL,
index f9b3099efcfaf1fd406c651b05a512506f48cb73..3feadfd4931871b85b19ea1e0ccb8b840f87cb4f 100644 (file)
@@ -722,7 +722,7 @@ class CRM_Contact_BAO_Relationship extends CRM_Contact_DAO_Relationship {
    *   This is contact id for adding relationship.
    *
    * @return string
-  @access public
+   * @access public
    * @static
    */
   public static function checkValidRelationship($params, $ids, $contactId) {
index c8acb4d0df6d8922424419a16293b73f6bccb8e7..e8dee4b0a8f765c8c85221fa800fa01865daa517 100644 (file)
@@ -119,7 +119,7 @@ class CRM_Contact_Selector_Custom extends CRM_Contact_Selector {
    * @param null $contextMenu
    *
    * @return \CRM_Contact_Selector_Custom
-  @access public
+   * @access public
    */
   function __construct(
     $customSearchClass,
index 8a3f10c72fa3aaccba77f2dd3b025535d46509c7..aed61ada1c2eea0dbdf28e100c42006b6482daf0 100644 (file)
@@ -165,7 +165,7 @@ class CRM_Contribute_Selector_Search extends CRM_Core_Selector_Base implements C
    * @param null $compContext
    *
    * @return \CRM_Contribute_Selector_Search
-  @access public
+   * @access public
    */
   function __construct(
     &$queryParams,
index 18a4cffd5a32115ec08952b30bd255a220506d1e..eb8c70d806adf4ff30ef5e816ad390589d044884 100644 (file)
@@ -80,7 +80,7 @@ class CRM_Core_DAO extends DB_DataObject {
    * Class constructor
    *
    * @return \CRM_Core_DAO
-  @access public
+   * @access public
    */
   public function __construct() {
     $this->initialize();
index 36a65562ca825561b744472990fcab84fc4fd178..7aecbd07b484f27e66eea5ce7cbcd93047f3a7f0 100644 (file)
@@ -54,7 +54,7 @@ class CRM_Core_QuickForm_Action extends HTML_QuickForm_Action {
    *   Reference to state machine object.
    *
    * @return \CRM_Core_QuickForm_Action
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine) {
     $this->_stateMachine = &$stateMachine;
index 198e0d1b7c2fd4848074a4ad2da7ad737ee46bd9..5d548aa5325faec5d01e2438b04e771e03814162 100644 (file)
@@ -42,7 +42,7 @@ class CRM_Core_QuickForm_Action_Cancel extends CRM_Core_QuickForm_Action {
    *   Reference to state machine object.
    *
    * @return \CRM_Core_QuickForm_Action_Cancel
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine) {
     parent::__construct($stateMachine);
index c92139478be7cfd75ae4fdf3af09fdbf09dde728..54a127d1b8337d127bb4f494bf0199ba9352788a 100644 (file)
@@ -54,7 +54,7 @@ class CRM_Core_QuickForm_Action_Display extends CRM_Core_QuickForm_Action {
    *   Reference to state machine object.
    *
    * @return \CRM_Core_QuickForm_Action_Display
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine) {
     parent::__construct($stateMachine);
index e1fbff43091c5175900235fe9a78bc8001fb3b41..88cc21d7b920546e1b891c9f6ca78191fcc08a5a 100644 (file)
@@ -42,7 +42,7 @@ class CRM_Core_QuickForm_Action_Done extends CRM_Core_QuickForm_Action {
    *   Reference to state machine object.
    *
    * @return \CRM_Core_QuickForm_Action_Done
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine) {
     parent::__construct($stateMachine);
index 52ff324167cacdc57eba63684e99ce408731453d..d77008b0658b1c4448ca4fcac7c5f82edd6bf106 100644 (file)
@@ -42,7 +42,7 @@ class CRM_Core_QuickForm_Action_Jump extends CRM_Core_QuickForm_Action {
    *   Reference to state machine object.
    *
    * @return \CRM_Core_QuickForm_Action_Jump
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine) {
     parent::__construct($stateMachine);
index 8df1e00bf8b8e35c422a6a9f994d5c8222ee3b11..6ad9ecce619cb18b59b017edc80d2d12abd81c43 100644 (file)
@@ -42,7 +42,7 @@ class CRM_Core_QuickForm_Action_Next extends CRM_Core_QuickForm_Action {
    *   Reference to state machine object.
    *
    * @return \CRM_Core_QuickForm_Action_Next
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine) {
     parent::__construct($stateMachine);
index eb47b050b52c641db68b51dbb48d1cb8accc7f3c..f65b18b70610fa8206341ba1392c407ee80ad526 100644 (file)
@@ -42,7 +42,7 @@ class CRM_Core_QuickForm_Action_Process extends CRM_Core_QuickForm_Action {
    *   Reference to state machine object.
    *
    * @return \CRM_Core_QuickForm_Action_Process
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine) {
     parent::__construct($stateMachine);
index f5efbc4d8ee8c60d8cdb78b2966445b803bda6ca..9990687560fff04235cd05b8c253f3efea0ecb7b 100644 (file)
@@ -42,7 +42,7 @@ class CRM_Core_QuickForm_Action_Refresh extends CRM_Core_QuickForm_Action {
    *   Reference to state machine object.
    *
    * @return \CRM_Core_QuickForm_Action_Refresh
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine) {
     parent::__construct($stateMachine);
index 69d5fc36d44f3eb611ba0d7c73629b801a4cac10..439665363ad1fe51768c54008fa26095c980aa23 100644 (file)
@@ -45,7 +45,7 @@ class CRM_Core_QuickForm_Action_Reload extends CRM_Core_QuickForm_Action {
    *   Reference to state machine object.
    *
    * @return \CRM_Core_QuickForm_Action_Reload
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine) {
     parent::__construct($stateMachine);
index 7becd87e3a95561f696a8ef41ea399e612f027a5..b5bf6c625bf43e35092b118585c3b2d3121b17bb 100644 (file)
@@ -42,7 +42,7 @@ class CRM_Core_QuickForm_Action_Submit extends CRM_Core_QuickForm_Action {
    *   Reference to state machine object.
    *
    * @return \CRM_Core_QuickForm_Action_Submit
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine) {
     parent::__construct($stateMachine);
index 8359a7867afa1318765ffa9fe4052e662a147869..7d398c3a49383b235a460d71056700114e0f6f09 100644 (file)
@@ -58,7 +58,7 @@ class CRM_Core_QuickForm_Action_Upload extends CRM_Core_QuickForm_Action {
    *   Element names of the various uploadable files.
    *
    * @return \CRM_Core_QuickForm_Action_Upload
-  @access public
+   * @access public
    */
   public function __construct(&$stateMachine, $uploadDir, $uploadNames) {
     parent::__construct($stateMachine);
index cc2c5d48e10173ec6fe3044c07337d4a907a95e5..534cef9eb49c1a613cc031ba4359c588ef37e8de 100644 (file)
@@ -193,7 +193,7 @@ class CRM_Core_Selector_Controller {
    * @param null $case
    *
    * @return \CRM_Core_Selector_Controller
-  @access public
+   * @access public
    */
   public function __construct($object, $pageID, $sortID, $action, $store = NULL, $output = self::TEMPLATE, $prefix = NULL, $case = NULL) {
 
index a9bff2481f89bdb33d0fd58b350f7dca7cc5f28c..ed0886fc1fae4679ed62899f2829e8b97ab34a6d 100644 (file)
@@ -91,7 +91,7 @@ class CRM_Core_StateMachine {
    * @param \const|int $action
    *
    * @return \CRM_Core_StateMachine
-  @access public
+   * @access public
    */
   public function __construct(&$controller, $action = CRM_Core_Action::NONE) {
     $this->_controller = &$controller;
index ea97eb5afbfe7f086d8bff35906e74939fe19275..24e23b36a808f15dfe8021dcf4bb98c2bc51f227 100644 (file)
@@ -159,7 +159,7 @@ class CRM_Event_Selector_Search extends CRM_Core_Selector_Base implements CRM_Co
    * @param null $compContext
    *
    * @return \CRM_Event_Selector_Search
-  @access public
+   * @access public
    */
   function __construct(
     &$queryParams,
index 1926804fbdcacc3679443863c122476462d78338..6eac34c6fcac42b3f2db885d077ba9ffbe76640a 100644 (file)
@@ -36,7 +36,7 @@
 class CRM_Extension_Manager_Payment extends CRM_Extension_Manager_Base {
 
   /**
-  @var CRM_Extension_Mapper
+   * @var CRM_Extension_Mapper
    */
   protected $mapper;
 
index 09e9b67acf75653fabb634323c233a98ec8d72b9..4905763d86712ef524f93111312a1b1e47cc0733 100644 (file)
@@ -145,7 +145,7 @@ class CRM_Grant_Selector_Search extends CRM_Core_Selector_Base implements CRM_Co
    * @param string $context
    *
    * @return \CRM_Grant_Selector_Search
-  @access public
+   * @access public
    */
   function __construct(
     &$queryParams,
index 44d3b49bda4576d6f4a1ad5c194f3e7e339e79a5..fd75d3329b76325c2f28fb0c7156ad0687701948 100644 (file)
@@ -61,7 +61,7 @@ class CRM_Mailing_Selector_Browse extends CRM_Core_Selector_Base implements CRM_
    *
    *
    * @return \CRM_Mailing_Selector_Browse
-  @access public
+   * @access public
    */
   public function __construct() {
   }
index 4a36c1cb2604e70838f33b5a5ddae0317e75f4aa..fec0d400d610eb248d180517f2bc2567fb9b824a 100644 (file)
@@ -96,7 +96,7 @@ class CRM_Mailing_Selector_Event extends CRM_Core_Selector_Base implements CRM_C
    *   If the event type is a click-through, do we want only those from a specific url?.
    *
    * @return \CRM_Mailing_Selector_Event
-  @access public
+   * @access public
    */
   public function __construct($event, $distinct, $mailing, $job = NULL, $url = NULL) {
     $this->_event_type  = $event;
index d1d93befcfecdf6f17f2edcc55e56ad1c9cb9392..d326e753c06e7a5a58761fd11012e07a4dc49877 100644 (file)
@@ -149,7 +149,7 @@ class CRM_Mailing_Selector_Search extends CRM_Core_Selector_Base implements CRM_
    * @param null $compContext
    *
    * @return \CRM_Mailing_Selector_Search
-  @access public
+   * @access public
    */
   function __construct(
     &$queryParams,
index bc20c9318ad5c33feac8d114d7df9ae52f071689..7f1d6e6c5132cb9d614906b641c4acf661245c53 100644 (file)
@@ -232,7 +232,7 @@ class CRM_Member_BAO_MembershipStatus extends CRM_Member_DAO_MembershipStatus {
    *   Membership params as available to calling function - passed to the hook.
    *
    * @return array
-  @static
+   * @static
    */
   static function getMembershipStatusByDate(
     $startDate, $endDate, $joinDate,
@@ -384,7 +384,7 @@ class CRM_Member_BAO_MembershipStatus extends CRM_Member_DAO_MembershipStatus {
    * Function that return the status ids whose is_current_member is set
    *
    * @return array
-  @static
+   * @static
    */
   public static function getMembershipStatusCurrent() {
     $statusIds = array();
index b1463e0f06c292a8a3a6f2c9900dd53502af48e8..2206144284ea71f5620cededb02db342a4b407ba 100644 (file)
@@ -145,7 +145,7 @@ class CRM_Member_Selector_Search extends CRM_Core_Selector_Base implements CRM_C
    * @param string $context
    *
    * @return \CRM_Member_Selector_Search
-  @access public
+   * @access public
    */
   function __construct(
     &$queryParams,
index 1f867ceb8dcc1ecae79fc1b7195c509d935fbd43..160d3dd02b8404882db89bd466a8dc80b6d750da 100644 (file)
@@ -148,7 +148,7 @@ class CRM_Pledge_Selector_Search extends CRM_Core_Selector_Base {
    * @param string $context
    *
    * @return \CRM_Pledge_Selector_Search
-  @access public
+   * @access public
    */
   function __construct(
     &$queryParams,
index 1d8cbffcddd01187da34c76ac05ff169a19dba36..f464c7b297e0fab08c41d6e12c6c9268f389ac84 100644 (file)
@@ -140,7 +140,7 @@ class CRM_Profile_Selector_Listings extends CRM_Core_Selector_Base implements CR
    * @param bool $linkToUF
    *
    * @return \CRM_Profile_Selector_Listings
-  @access public
+   * @access public
    */
   function __construct(
     &$params,
index 2114c9e575573f5edce4f9d2b09157a8878b2b00..f72b5a5360f451da0236d19aeb063256699e6671 100644 (file)
@@ -91,7 +91,7 @@ class CRM_Upgrade_Form extends CRM_Core_Form {
    *   The name of the form if different from class name.
    *
    * @return \CRM_Core_Form
-  @access public
+   * @access public
    */
   /**
    * @param null|object $state
index 8701fcb55d93442aa1a97057d5a82b7aa604fcb0..c9a30738e5ae2fdeec72578e04625ac49e6bf098 100644 (file)
@@ -122,7 +122,7 @@ class CRM_Utils_Sort {
    *   Order to sort.
    *
    * @return \CRM_Utils_Sort
-  @access public
+   * @access public
    */
   public function __construct(&$vars, $defaultSortOrder = NULL) {
     $this->_vars = array();
index 56a416c41ddb0a2ccd1b432edeef80b60756906e..3a73c916d3e89531b27be684c78302de77f57431 100644 (file)
  * @version $Id: CustomField.php 30879 2010-11-22 15:45:55Z shot $
  */
 
-/**
- * Most API functions take in associative arrays ( name => value pairs
- * as parameters. Some of the most commonly used parameters are
- * described below
- *
- * @param array $params
- *   An associative array used in construction.
- * retrieval of the object
- *
- */
-
 /**
  * Create a 'custom field' within a custom field group.
  * We also empty the static var in the getfields
@@ -56,7 +45,8 @@
  * @param $params
  *   Array Associative array of property name/value pairs to create new custom field.
  *
- * @return Newly API success object
+ * @return array
+ *   API success array
  *
  * @access public
  *
@@ -90,6 +80,7 @@ function _civicrm_api3_custom_field_flush_static_caches() {
   civicrm_api('custom_field', 'getfields', array('version' => 3, 'cache_clear' => 1));
   CRM_Core_BAO_UFField::getAvailableFieldsFlat(TRUE);
 }
+
 /**
  * Adjust Metadata for Create action
  *
@@ -123,7 +114,6 @@ function _civicrm_api3_custom_field_create_spec(&$params) {
  * @access public
  **/
 function civicrm_api3_custom_field_delete($params) {
-
   $field = new CRM_Core_BAO_CustomField();
   $field->id = $params['id'];
   $field->find(TRUE);
@@ -137,10 +127,9 @@ function civicrm_api3_custom_field_delete($params) {
  *
  * @param array $params
  *   Array to search on.
- * {*
  *
  * @return array
-@getfields CustomField_get}
+ * @getfields CustomField_get
  * @access public
  *
  **/
@@ -162,7 +151,7 @@ function civicrm_api3_custom_field_get($params) {
  *   Collect validation errors.
  *
  * @return array
  *   Validation errors
+ *   Validation errors
  * @todo remove this function - not in use but need to review functionality before
  * removing as it might be useful in wrapper layer
  */