CRM-15988 - Cleanup internal use of entity names

[civicrm-core.git] / CRM / Core / State.php

diff --git a/CRM/Core/State.php b/CRM/Core/State.php
index b6641fa47cbb58ed0a186f5e48210d8b585f341e..323dc3df39944a90de4783ed132d74712ba17a20 100644 (file)
--- a/CRM/Core/State.php
+++ b/CRM/Core/State.php
@@ -23,7 +23,7 @@
  | GNU Affero General Public License or the licensing of CiviCRM,     |
  | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
  +--------------------------------------------------------------------+
-*/
+ */
 
 /**
  * The basic state element. Each state element is linked to a form and
@@ -39,7 +39,7 @@
 class CRM_Core_State {
 
   /**
-   * State name
+   * State name.
    * @var string
    */
   protected $_name;
@@ -51,19 +51,19 @@ class CRM_Core_State {
   protected $_type;
 
   /**
-   * The state that precedes this state
+   * The state that precedes this state.
    * @var CRM_Core_State
    */
   protected $_back;
 
   /**
-   * The state that succeeds this state
+   * The state that succeeds this state.
    * @var CRM_Core_State
    */
   protected $_next;
 
   /**
-   * The state machine that this state is part of
+   * The state machine that this state is part of.
    * @var CRM_Core_StateMachine
    */
   protected $_stateMachine;
@@ -77,7 +77,7 @@ class CRM_Core_State {
   const START = 1, FINISH = 2, SIMPLE = 4;
 
   /**
-   * Constructor
+   * Constructor.
    *
    * @param string $name
    *   Internal name of the state.
@@ -108,9 +108,8 @@ class CRM_Core_State {
   /**
    * Given an CRM Form, jump to the previous page
    *
-   * @param object the CRM_Core_Form element under consideration
-   *
-   * @return mixed does a jump to the back state
+   * @return mixed
+   *   does a jump to the back state
    */
   public function handleBackState(&$page) {
     if ($this->_type & self::START) {
@@ -125,9 +124,8 @@ class CRM_Core_State {
   /**
    * Given an CRM Form, jump to the next page
    *
-   * @param object the CRM_Core_Form element under consideration
-   *
-   * @return mixed does a jump to the nextstate
+   * @return mixed
+   *   does a jump to the nextstate
    */
   public function handleNextState(&$page) {
     if ($this->_type & self::FINISH) {
@@ -159,8 +157,6 @@ class CRM_Core_State {
    * Mark this page as valid for the QFC framework. This is needed as
    * we build more advanced functionality into the StateMachine
    *
-   * @param object the QFC data container
-   *
    * @return void
    */
   public function validate(&$data) {
@@ -171,8 +167,6 @@ class CRM_Core_State {
    * Mark this page as invalid for the QFC framework. This is needed as
    * we build more advanced functionality into the StateMachine
    *
-   * @param object the QFC data container
-   *
    * @return void
    */
   public function invalidate(&$data) {
@@ -180,7 +174,7 @@ class CRM_Core_State {
   }
 
   /**
-   * Getter for name
+   * Getter for name.
    *
    * @return string
    */
@@ -189,9 +183,7 @@ class CRM_Core_State {
   }
 
   /**
-   * Setter for name
-   *
-   * @param string
+   * Setter for name.
    *
    * @return void
    */
@@ -200,11 +192,12 @@ class CRM_Core_State {
   }
 
   /**
-   * Getter for type
+   * Getter for type.
    *
    * @return int
    */
   public function getType() {
     return $this->_type;
   }
+
 }