pradosoft / prado

framework/Web/UI/TControl.php

Doc Comments +9 added lines, -9 removed lines

@@ -214,7 +214,7 @@ 
 	 * the control ID will take the precedence.
 	 *
 	 * @param string $name the property name or control ID
-	 * @return bool wether the control or property exists
+	 * @return boolean|null wether the control or property exists
 	 * @see __get
 	 */
 	public function __isset($name)
@@ -471,7 +471,7 @@ 
 	}
 
 	/**
-	 * @return bool if a skin is applied.
+	 * @return integer if a skin is applied.
 	 */
 	public function getIsSkinApplied()
 	{
@@ -648,7 +648,7 @@ 
 	}
 
 	/**
-	 * @param mixed $name
+	 * @param string $name
 	 * @return bool whether the named attribute exists
 	 */
 	public function hasAttribute($name)
@@ -661,7 +661,7 @@ 
 	}
 
 	/**
-	 * @param mixed $name
+	 * @param string $name
 	 * @return string attribute value, null if attribute does not exist
 	 */
 	public function getAttribute($name)
@@ -698,7 +698,7 @@ 
 	}
 
 	/**
-	 * @param mixed $checkParents
+	 * @param boolean $checkParents
 	 * @return bool whether viewstate is enabled
 	 */
 	public function getEnableViewState($checkParents = false)
@@ -733,7 +733,7 @@ 
 	 * This function is mainly used in defining getter functions for control properties
 	 * that must be kept in controlstate.
 	 * @param string $key the name of the controlstate value to be returned
-	 * @param mixed $defaultValue the default value. If $key is not found in controlstate, $defaultValue will be returned
+	 * @param integer|null $defaultValue the default value. If $key is not found in controlstate, $defaultValue will be returned
 	 * @return mixed the controlstate value corresponding to $key
 	 */
 	protected function getControlState($key, $defaultValue = null)
@@ -749,7 +749,7 @@ 
 	 * Make sure that the controlstate value must be serializable and unserializable.
 	 * @param string $key the name of the controlstate value
 	 * @param mixed $value the controlstate value to be set
-	 * @param null|mixed $defaultValue default value. If $value===$defaultValue, the item will be cleared from controlstate
+	 * @param integer $defaultValue default value. If $value===$defaultValue, the item will be cleared from controlstate
 	 */
 	protected function setControlState($key, $value, $defaultValue = null)
 	{
@@ -1084,7 +1084,7 @@ 
 	 * A registered object can be accessed like a public member variable.
 	 * This method should only be used by framework and control developers.
 	 * @param string $name name of the object
-	 * @param object $object object to be declared
+	 * @param \Prado\TComponent $object object to be declared
 	 * @see __get
 	 */
 	public function registerObject($name, $object)
@@ -1160,7 +1160,7 @@ 
 	 * A component with explicit ID on a template will be registered to
 	 * the template owner. This method allows you to obtain this component
 	 * with the ID.
-	 * @param mixed $name
+	 * @param string $name
 	 * @return mixed the named registered object. Null if object is not found.
 	 */
 	public function getRegisteredObject($name)

framework/Web/UI/TPage.php

Doc Comments +6 added lines, -3 removed lines

@@ -290,6 +290,9 @@ 
 		$this->unloadRecursive();
 	}
 
+	/**
+	 * @param string $enc
+	 */
 	protected static function decodeUTF8($data, $enc)
 	{
 		if (is_array($data)) {
@@ -970,7 +973,7 @@ 
 
 	/**
 	 * @internal This method is invoked by TForm at the beginning of its rendering
-	 * @param mixed $writer
+	 * @param THtmlWriter $writer
 	 */
 	public function beginFormRender($writer)
 	{
@@ -984,7 +987,7 @@ 
 
 	/**
 	 * @internal This method is invoked by TForm  at the end of its rendering
-	 * @param mixed $writer
+	 * @param THtmlWriter $writer
 	 */
 	public function endFormRender($writer)
 	{
@@ -1003,7 +1006,7 @@ 
 
 	/**
 	 * Sets input focus on a control after the page is rendered to users.
-	 * @param string|TControl $value control to receive focus, or the ID of the element on the page to receive focus
+	 * @param TControl $value control to receive focus, or the ID of the element on the page to receive focus
 	 */
 	public function setFocus($value)
 	{

framework/Web/UI/TPageStateFormatter.php

Doc Comments +1 added lines, -1 removed lines

@@ -55,7 +55,7 @@
 	/**
 	 * @param TPage $page
 	 * @param string $data serialized data
-	 * @return mixed unserialized state data, null if data is corrupted
+	 * @return string unserialized state data, null if data is corrupted
 	 */
 	public static function unserialize($page, $data)
 	{

framework/Web/UI/TTemplate.php

Doc Comments +2 added lines, -2 removed lines

@@ -869,7 +869,7 @@ 
 	 * Handles template parsing exception.
 	 * This method rethrows the exception caught during template parsing.
 	 * It adjusts the error location by giving out correct error line number and source file.
-	 * @param Exception $e template exception
+	 * @param \Exception $e template exception
 	 * @param int $line line number
 	 * @param null|string $input template string if no source file is used
 	 */
@@ -934,7 +934,7 @@ 
 
 	/**
 	 * Checks if the given method belongs to a previously attached class behavior.
-	 * @param ReflectionClass $class
+	 * @param \ReflectionClass $class
 	 * @param string $method
 	 * @return bool
 	 */

framework/Web/UI/TTemplateManager.php

Doc Comments +1 added lines, -1 removed lines

@@ -70,7 +70,7 @@
 
 	/**
 	 * Loads the template from the specified file.
-	 * @param mixed $fileName
+	 * @param string $fileName
 	 * @return ITemplate template parsed from the specified file, null if the file doesn't exist.
 	 */
 	public function getTemplateByFileName($fileName)

framework/Web/UI/WebControls/TBaseDataList.php

Doc Comments +1 added lines, -1 removed lines

@@ -167,7 +167,7 @@
 	 * as the field name, the property value will be returned.
 	 * Otherwise, an exception will be raised.
 	 * @param mixed $data data item
-	 * @param mixed $field field name
+	 * @param string $field field name
 	 * @throws TInvalidDataValueException if the data is invalid
 	 * @return mixed data value at the specified field
 	 */

framework/Web/UI/WebControls/TBaseValidator.php

Doc Comments +3 added lines, -3 removed lines

@@ -188,7 +188,7 @@ 
 	 * Gets the Control type for client-side validation. If new cases exists in
 	 * TBaseValidator::$_clientClass, be sure to update the corresponding
 	 * "Javascript/validation3.js" file as well.
-	 * @param TControl $control control to validate.
+	 * @param \Prado\Web\UI\TControl $control control to validate.
 	 * @return string control type for client-side validation.
 	 */
 	private function getClientControlClass($control)
@@ -272,7 +272,7 @@ 
 	/**
 	 * Update the ControlToValidate component's css class depending
 	 * if the ControlCssClass property is set, and whether this is valid.
-	 * @return bool true if change, false otherwise.
+	 * @return boolean|null true if change, false otherwise.
 	 */
 	protected function updateControlCssClass()
 	{
@@ -483,7 +483,7 @@ 
 	/**
 	 * @throws TConfigurationException if {@link getControlToValidate
 	 * ControlToValidate} is empty or does not point to a valid control
-	 * @return TControl control to be validated. Null if no control is found.
+	 * @return \Prado\Web\UI\TControl control to be validated. Null if no control is found.
 	 */
 	public function getValidationTarget()
 	{

framework/Web/UI/WebControls/TBulletedList.php

Doc Comments +12 added lines

@@ -296,6 +296,10 @@ 
 		}
 	}
 
+	/**
+	 * @param TListItem $item
+	 * @param integer $index
+	 */
 	protected function renderTextItem($writer, $item, $index)
 	{
 		if ($item->getEnabled()) {
@@ -308,6 +312,10 @@ 
 		}
 	}
 
+	/**
+	 * @param TListItem $item
+	 * @param integer $index
+	 */
 	protected function renderHyperLinkItem($writer, $item, $index)
 	{
 		if (!$this->_isEnabled || !$item->getEnabled()) {
@@ -326,6 +334,10 @@ 
 		$writer->renderEndTag();
 	}
 
+	/**
+	 * @param TListItem $item
+	 * @param integer $index
+	 */
 	protected function renderLinkButtonItem($writer, $item, $index)
 	{
 		if (!$this->_isEnabled || !$item->getEnabled()) {

framework/Web/UI/WebControls/TButton.php

Doc Comments +1 added lines, -1 removed lines

@@ -243,7 +243,7 @@
 	 * invoke the page's {@link TPage::validate validate} method first.
 	 * It will raise {@link onClick OnClick} and {@link onCommand OnCommand} events.
 	 * This method is mainly used by framework and control developers.
-	 * @param TEventParameter $param the event parameter
+	 * @param \Prado\Web\UI\ActiveControls\TCallbackEventParameter $param the event parameter
 	 */
 	public function raisePostBackEvent($param)
 	{