Phpdoc and small text fixes

refs #4524

modules/monitoring/application/forms/Command/AcknowledgeForm.php

@@ -73,7 +73,7 @@ class AcknowledgeForm extends CommandForm
                 array(
                     'name'  => 'commentnote',
                     'value' => t(
-                        ' If you work with other administrators, you may find it useful to share information '
+                        ' If you work with other administrators you may find it useful to share information '
                         . 'about a host or service that is having problems if more than one of you may be working on '
                         . 'it. Make sure you enter a brief description of what you are doing.'
                     )
@@ -94,7 +94,7 @@ class AcknowledgeForm extends CommandForm
                 array(
                     'name'  => 'persistentnote',
                     'value' => t(
-                        'If you would like the comment to remain once the acknowledgement is removed, '
+                        'If you would like the comment to remain even when the acknowledgement is removed, '
                         . 'check this option.'
                     )
                 )
@@ -133,8 +133,8 @@ class AcknowledgeForm extends CommandForm
                     array(
                         'name'  => 'expiretimenote',
                         'value' => t(
-                            'Enter here the expire date/time for this acknowledgement. Icinga will '
-                            . ' delete the acknowledgement after this time expired.'
+                            'Enter the expire date/time for this acknowledgement here. Icinga will '
+                            . ' delete the acknowledgement after this date expired.'
                         )
                     )
                 )
@@ -174,7 +174,7 @@ class AcknowledgeForm extends CommandForm
                 array(
                     'name'  => 'sendnotificationnote',
                     'value' => t(
-                        'If you do not want an acknowledgement notification sent out to the appropriate '
+                        'If you do not want an acknowledgement notification to be sent out to the appropriate '
                         . 'contacts, uncheck this option.'
                     )
                 )

modules/monitoring/application/forms/Command/CommandWithIdentifierForm.php

@@ -37,6 +37,7 @@ class CommandWithIdentifierForm extends CommandForm
 {
     /**
      * Identifier for data field
+     *
      * @var string
      */
     private $fieldName = 'objectid';
@@ -52,6 +53,7 @@ class CommandWithIdentifierForm extends CommandForm
 
     /**
      * Setter for field label
+     *
      * @param string $fieldLabel
      */
     public function setFieldLabel($fieldLabel)
@@ -61,6 +63,7 @@ class CommandWithIdentifierForm extends CommandForm
 
     /**
      * Getter for field label
+     *
      * @return string
      */
     public function getFieldLabel()
@@ -70,6 +73,7 @@ class CommandWithIdentifierForm extends CommandForm
 
     /**
      * Setter for field name
+     *
      * @param string $fieldName
      */
     public function setFieldName($fieldName)
@@ -79,6 +83,7 @@ class CommandWithIdentifierForm extends CommandForm
 
     /**
      * Getter for field name
+     *
      * @return string
      */
     public function getFieldName()

modules/monitoring/application/forms/Command/CustomNotificationForm.php

@@ -91,7 +91,7 @@ class CustomNotificationForm extends CommandForm
                     'name'  => 'forcenote',
                     'value' => t(
                         'Custom notifications normally follow the regular notification logic in Icinga. Selecting this '
-                        . 'option will force the notification to be sent out, regardless of the time restrictions, '
+                        . 'option will force the notification to be sent out, regardless of time restrictions, '
                         . 'whether or not notifications are enabled, etc.'
                     )
                 )

modules/monitoring/application/forms/Command/DelayNotificationForm.php

@@ -85,6 +85,11 @@ class DelayNotificationForm extends CommandForm
         parent::create();
     }
 
+    /**
+     * Return the currently set delay time in seconds
+     *
+     * @return integer
+     */
     public function getDelayTime()
     {
         return $this->getValue('minutes') * 60;

modules/monitoring/application/forms/Command/RescheduleNextCheckForm.php

@@ -108,6 +108,11 @@ class RescheduleNextCheckForm extends WithChildrenCommandForm
         parent::create();
     }
 
+    /**
+     * Return whether this is a forced check (force is checked)
+     *
+     * @return bool
+     */
     public function isForced()
     {
         return $this->getValue('forcecheck') == true;

modules/monitoring/application/forms/Command/SubmitPassiveCheckResultForm.php

@@ -209,16 +209,31 @@ class SubmitPassiveCheckResultForm extends CommandForm
         parent::create();
     }
 
+    /**
+     * Return the entered object state as an integer
+     *
+     * @return int
+     */
     public function getState()
     {
         return intval($this->getValue('pluginstate'));
     }
 
+    /**
+     * Return the entered check output as a string
+     *
+     * @return string
+     */
     public function getOutput()
     {
         return $this->getValue('checkoutput');
     }
 
+    /**
+     * Return the entered performance data as a string
+     *
+     * @return string
+     */
     public function getPerformancedata()
     {
         return $this->getValue('performancedata');