INFRA-132 add full-stops after comments
authorEileen McNaughton <eileen@fuzion.co.nz>
Wed, 4 Feb 2015 00:08:49 +0000 (13:08 +1300)
committerEileen McNaughton <eileen@fuzion.co.nz>
Wed, 4 Feb 2015 00:08:49 +0000 (13:08 +1300)
13 files changed:
CRM/Batch/Form/Entry.php
CRM/Core/BAO/Note.php
CRM/Core/BAO/OptionValue.php
CRM/Core/BAO/Persistent.php
CRM/Core/BAO/Setting.php
CRM/Core/CodeGen/Util/Template.php
CRM/Core/CommunityMessages.php
CRM/Core/Component.php
CRM/Core/Component/Info.php
CRM/Core/Config.php
CRM/Core/Controller.php
CRM/Core/Error.php
CRM/Core/Exception.php

index 254ab79447e62f95b6267f883e9ca2ae89261bd6..b6c9741477677476e2b48206bca31a3f72ce9760 100755 (executable)
@@ -71,12 +71,12 @@ class CRM_Batch_Form_Entry extends CRM_Core_Form {
   protected $_preserveDefault = TRUE;
 
   /**
-   * Contact fields
+   * Contact fields.
    */
   protected $_contactFields = array();
 
   /**
-   * Fields array of fields in the batch profile
+   * Fields array of fields in the batch profile.
    * (based on the uf_field table data)
    * (this can't be protected as it is passed into the CRM_Contact_Form_Task_Batch::parseStreetAddress function
    * (although a future refactoring might hopefully change that so it uses the api & the function is not
index 08ad15333bac4d8b33d699cb576c3b987323350d..1212c8e5cfb4971262da40148196229fcbb6c88a 100644 (file)
@@ -39,7 +39,7 @@
 class CRM_Core_BAO_Note extends CRM_Core_DAO_Note {
 
   /**
-   * Const the max number of notes we display at any given time
+   * Const the max number of notes we display at any given time.
    * @var int
    */
   const MAX_NOTES = 3;
index f0ce92cbfccaac8b67a306082005ccdff2289716..711d4c80e321a5bbc6cfa5cef37336e59ac19fc8 100644 (file)
@@ -105,7 +105,7 @@ class CRM_Core_BAO_OptionValue extends CRM_Core_DAO_OptionValue {
   }
 
   /**
-   * Get next available value
+   * Get next available value.
    * We will take the highest numeric value (or 0 if no numeric values exist)
    * and add one. The calling function is responsible for any
    * more complex decision making
index 467dca9958d00a56cfc3ba2747bab94ff658b16d..ae6e833d939ee94ce8b01dc52053f87d445542f4 100644 (file)
@@ -35,7 +35,7 @@
 class CRM_Core_BAO_Persistent extends CRM_Core_DAO_Persistent {
 
   /**
-   * Fetch object based on array of properties
+   * Fetch object based on array of properties.
    *
    * @param array $params
    *   (reference ) an assoc array of name/value pairs.
index 14d45628ca7c710d46b7718516503846a3af65ec..7b064345a3092ba3c467791491c01f95210b234e 100644 (file)
@@ -749,7 +749,7 @@ class CRM_Core_BAO_Setting extends CRM_Core_DAO_Setting {
   }
 
   /**
-   * Look for any missing settings and convert them from config or load default as appropriate
+   * Look for any missing settings and convert them from config or load default as appropriate.
    * This should be run from GenCode & also from upgrades to add any new defaults.
    *
    * Multisites have often been overlooked in upgrade scripts so can be expected to be missing
index 76042b2a7d9ce5c8cd79d6f6b9d10ec89ae30678..2590301c347a96d78a74e78a7ed1914e18622dd8 100644 (file)
@@ -83,7 +83,7 @@ class CRM_Core_CodeGen_Util_Template {
   }
 
   /**
-   * Clear the smarty cache and assign default values
+   * Clear the smarty cache and assign default values.
    * FIXME: unused cos we no longer do evil singleton magick
    */
   protected function reset() {
index 3db82150985c3c7f48c2dab0bb60a21130697d19..0141d7cedf759b90b92697013ef116b5265e9ffa 100644 (file)
@@ -34,7 +34,7 @@ class CRM_Core_CommunityMessages {
   const DEFAULT_PERMISSION = 'administer CiviCRM';
 
   /**
-   * Default time to wait before retrying
+   * Default time to wait before retrying.
    */
   const DEFAULT_RETRY = 7200; // 2 hours
 
@@ -54,7 +54,7 @@ class CRM_Core_CommunityMessages {
   protected $messagesUrl;
 
   /**
-   * Create default instance
+   * Create default instance.
    *
    * @return CRM_Core_CommunityMessages
    */
@@ -127,7 +127,7 @@ class CRM_Core_CommunityMessages {
   }
 
   /**
-   * Download document from URL and parse as JSON
+   * Download document from URL and parse as JSON.
    *
    * @return NULL|array
    *   parsed JSON
@@ -161,7 +161,7 @@ class CRM_Core_CommunityMessages {
   }
 
   /**
-   * Pick a message to display
+   * Pick a message to display.
    *
    * @return NULL|array
    */
index 0cc72ce62ccda3394ae3f8a727f6ef6affa39244..8a70a59a10eb9292d292274a880a74e3b48f9003 100644 (file)
@@ -420,7 +420,7 @@ class CRM_Core_Component {
   }
 
   /**
-   * Handle table dependencies of components
+   * Handle table dependencies of components.
    *
    * @param array $tables
    *   Array of tables.
@@ -438,7 +438,7 @@ class CRM_Core_Component {
   }
 
   /**
-   * Get components info from info file
+   * Get components info from info file.
    */
   public static function getComponentsFromFile($crmFolderDir) {
     $components = array();
index 882502ddb80154fe8c8fc11cd4ec29ff6ddfc501..0059dc4e6ca15523bb324e6336d21434c547a9e9 100644 (file)
@@ -185,7 +185,7 @@ abstract class CRM_Core_Component_Info {
   }
 
   /**
-   * Provides information about user dashboard element
+   * Provides information about user dashboard element.
    * offered by this component.
    *
    * @return array|null
@@ -195,7 +195,7 @@ abstract class CRM_Core_Component_Info {
   abstract public function getUserDashboardElement();
 
   /**
-   * Provides information about user dashboard element
+   * Provides information about user dashboard element.
    * offered by this component.
    *
    * @return array|null
index b53adaef3cd45d665f20ec49e53fe67dbaba229e..f4f909e450a8d1c1d651e3623a9f7db99bb40a8e 100644 (file)
@@ -91,7 +91,7 @@ class CRM_Core_Config extends CRM_Core_Config_Variables {
   public $userPermissionClass;
 
   /**
-   * The root directory where Smarty should store compiled files
+   * The root directory where Smarty should store compiled files.
    *
    * @var string
    */
@@ -667,7 +667,7 @@ class CRM_Core_Config extends CRM_Core_Config_Variables {
   }
 
   /**
-   * Verify that the needed parameters are not null in the config
+   * Verify that the needed parameters are not null in the config.
    *
    * @param CRM_Core_Config $config (reference) the system config object
    * @param array $required (reference) the parameters that need a value
@@ -684,7 +684,7 @@ class CRM_Core_Config extends CRM_Core_Config_Variables {
   }
 
   /**
-   * Reset the serialized array and recompute
+   * Reset the serialized array and recompute.
    * use with care
    */
   public function reset() {
@@ -693,7 +693,7 @@ class CRM_Core_Config extends CRM_Core_Config_Variables {
   }
 
   /**
-   * This method should initialize auth sources
+   * This method should initialize auth sources.
    */
   public function initAuthSrc() {
     $session = CRM_Core_Session::singleton();
@@ -706,7 +706,7 @@ class CRM_Core_Config extends CRM_Core_Config_Variables {
   }
 
   /**
-   * One function to get domain ID
+   * One function to get domain ID.
    */
   public static function domainID($domainID = NULL, $reset = FALSE) {
     static $domain;
@@ -768,7 +768,7 @@ class CRM_Core_Config extends CRM_Core_Config_Variables {
   }
 
   /**
-   * Flush information about loaded modules
+   * Flush information about loaded modules.
    */
   public function clearModuleList() {
     CRM_Extension_System::singleton()->getCache()->flush();
@@ -778,7 +778,7 @@ class CRM_Core_Config extends CRM_Core_Config_Variables {
   }
 
   /**
-   * Clear db cache
+   * Clear db cache.
    */
   public static function clearDBCache() {
     $queries = array(
@@ -802,7 +802,7 @@ class CRM_Core_Config extends CRM_Core_Config_Variables {
   }
 
   /**
-   * Clear leftover temporary tables
+   * Clear leftover temporary tables.
    */
   public static function clearTempTables() {
     // CRM-5645
@@ -833,7 +833,7 @@ AND
   }
 
   /**
-   * Check if running in upgrade mode
+   * Check if running in upgrade mode.
    */
   public static function isUpgradeMode($path = NULL) {
     if (defined('CIVICRM_UPGRADE_ACTIVE')) {
@@ -859,7 +859,7 @@ AND
   }
 
   /**
-   * Wrapper function to allow unit tests to switch user framework on the fly
+   * Wrapper function to allow unit tests to switch user framework on the fly.
    */
   public function setUserFramework($userFramework = NULL) {
     $this->userFramework = $userFramework;
index db8a6ed443deffe0727328c449fb4c71112a9220..7276ab5bd52121d6cb692f9829c052583d56113d 100644 (file)
@@ -408,7 +408,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Getter method for stateMachine
+   * Getter method for stateMachine.
    *
    * @return CRM_Core_StateMachine
    */
@@ -417,7 +417,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Setter method for stateMachine
+   * Setter method for stateMachine.
    *
    * @param CRM_Core_StateMachine $stateMachine
    *
@@ -515,7 +515,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Store the variable with the value in the form scope
+   * Store the variable with the value in the form scope.
    *
    * @param string|array $name name of the variable or an assoc array of name/value pairs
    * @param mixed $value
@@ -529,7 +529,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Get the variable from the form scope
+   * Get the variable from the form scope.
    *
    * @param string $name
    *   name of the variable.
@@ -542,7 +542,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Create the header for the wizard from the list of pages
+   * Create the header for the wizard from the list of pages.
    * Store the created header in smarty
    *
    * @param string $currentPageName
@@ -599,7 +599,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Assign value to name in template
+   * Assign value to name in template.
    *
    * @param string $var
    * @param mixed $value
@@ -612,7 +612,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Assign value to name in template by reference
+   * Assign value to name in template by reference.
    *
    * @param string $var
    * @param mixed $value
@@ -625,7 +625,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Appends values to template variables
+   * Appends values to template variables.
    *
    * @param array|string $tpl_var the template variable name(s)
    * @param mixed $value
@@ -637,7 +637,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Returns an array containing template variables
+   * Returns an array containing template variables.
    *
    * @param string $name
    *
@@ -648,7 +648,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Setter for embedded
+   * Setter for embedded.
    *
    * @param bool $embedded
    *
@@ -659,7 +659,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Getter for embedded
+   * Getter for embedded.
    *
    * @return bool
    *   return the embedded value
@@ -669,7 +669,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Setter for skipRedirection
+   * Setter for skipRedirection.
    *
    * @param bool $skipRedirection
    *
@@ -680,7 +680,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Getter for skipRedirection
+   * Getter for skipRedirection.
    *
    * @return bool
    *   return the skipRedirection value
@@ -719,7 +719,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Setter for print
+   * Setter for print.
    *
    * @param bool $print
    *
@@ -736,7 +736,7 @@ class CRM_Core_Controller extends HTML_QuickForm_Controller {
   }
 
   /**
-   * Getter for print
+   * Getter for print.
    *
    * @return bool
    *   return the print value
index 42c614e8f48e0c4c079ec43ffa225108a39f6c61..d3147a8e0f0aab71b3707fb3c192af9555706830 100644 (file)
@@ -73,7 +73,7 @@ class CRM_Exception extends PEAR_Exception {
 class CRM_Core_Error extends PEAR_ErrorStack {
 
   /**
-   * Status code of various types of errors
+   * Status code of various types of errors.
    */
   const FATAL_ERROR = 2;
   const DUPLICATE_CONTACT = 8001;
@@ -117,7 +117,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Constructor
+   * Constructor.
    */
   public function __construct() {
     parent::__construct('CiviCRM');
@@ -149,7 +149,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Status display function specific to payment processor errors
+   * Status display function specific to payment processor errors.
    * @param $error
    * @param string $separator
    */
@@ -292,7 +292,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Display an error page with an error message describing what happened
+   * Display an error page with an error message describing what happened.
    *
    * @param string $message
    *   The error message.
@@ -381,7 +381,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Display an error page with an error message describing what happened
+   * Display an error page with an error message describing what happened.
    *
    * This function is evil -- it largely replicates fatal(). Hopefully the
    * entire CRM_Core_Error system can be hollowed out and replaced with
@@ -560,7 +560,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Display the error message on terminal
+   * Display the error message on terminal.
    *
    * @param $message
    * @param bool $out
@@ -623,7 +623,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Obtain a reference to the error log
+   * Obtain a reference to the error log.
    *
    * @param string $comp
    *
@@ -673,7 +673,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Render a backtrace array as a string
+   * Render a backtrace array as a string.
    *
    * @param array $backTrace
    *   Array of stack frames.
@@ -694,7 +694,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Render a backtrace array as an array
+   * Render a backtrace array as an array.
    *
    * @param array $backTrace
    *   Array of stack frames.
@@ -772,7 +772,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Render an exception as HTML string
+   * Render an exception as HTML string.
    *
    * @param Exception $e
    * @return string
@@ -808,7 +808,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Write details of an exception to the log
+   * Write details of an exception to the log.
    *
    * @param Exception $e
    * @return string
@@ -870,7 +870,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Reset the error stack
+   * Reset the error stack.
    *
    */
   public static function reset() {
@@ -944,7 +944,7 @@ class CRM_Core_Error extends PEAR_ErrorStack {
   }
 
   /**
-   * Terminate execution abnormally
+   * Terminate execution abnormally.
    */
   protected static function abend($code) {
     // do a hard rollback of any pending transactions
index 13f4e2d19124a762e0cfc23d8ffda70b4da68d36..2722c6b73bb5cd5cafa20ca3ba591d63fe323333 100644 (file)
@@ -52,7 +52,7 @@ class CRM_Core_Exception extends PEAR_Exception {
   }
 
   /**
-   * custom string representation of object
+   * custom string representation of object.
    * @return string
    */
   public function __toString() {