pradosoft / prado

framework/Web/UI/JuiControls/TJuiControlOptions.php

Doc Comments +1 added lines, -1 removed lines

@@ -126,7 +126,7 @@
 
 	/**
 	 * Only serialize the options itself, not the corresponding parent control.
-	 * @return mixed array with the names of all variables of that object that should be serialized.
+	 * @return string[] array with the names of all variables of that object that should be serialized.
 	 */
 	public function __sleep()
 	{

framework/Web/UI/TClientScriptManager.php

Doc Comments +20 added lines, -5 removed lines

@@ -221,7 +221,7 @@ 
 	}
 
 	/**
-	 * @param mixed $script
+	 * @param string $script
 	 * @return string Prado javascript library base asset url.
 	 */
 	public function getPradoScriptAssetUrl($script = 'prado')
@@ -236,7 +236,7 @@ 
 	}
 
 	/**
-	 * @param mixed $script
+	 * @param string $script
 	 * @return string Prado javascript library base asset path in local filesystem.
 	 */
 	public function getPradoScriptAssetPath($script = 'prado')
@@ -265,7 +265,7 @@ 
 
 	/**
 	 * @param string $base javascript or css package path.
-	 * @return array tuple($path,$url).
+	 * @return string[] tuple($path,$url).
 	 */
 	protected function getPackagePathUrl($base)
 	{
@@ -446,7 +446,7 @@ 
 
 	/**
 	 * Registers a Prado style library to be loaded.
-	 * @param mixed $name
+	 * @param string $name
 	 */
 	protected function registerPradoStyleInternal($name)
 	{
@@ -784,11 +784,17 @@ 
 		$writer->write(TJavaScript::renderScriptBlocks($this->_headScripts));
 	}
 
+	/**
+	 * @param THtmlWriter $writer
+	 */
 	public function renderScriptFilesBegin($writer)
 	{
 		$this->renderAllPendingScriptFiles($writer);
 	}
 
+	/**
+	 * @param THtmlWriter $writer
+	 */
 	public function renderScriptFilesEnd($writer)
 	{
 		$this->renderAllPendingScriptFiles($writer);
@@ -801,6 +807,9 @@ 
 		$this->_page->registerCachingAction('Page.ClientScript', 'markScriptFileAsRendered', $params);
 	}
 
+	/**
+	 * @param THtmlWriter $writer
+	 */
 	protected function renderScriptFiles($writer, array $scripts)
 	{
 		foreach ($scripts as $script) {
@@ -857,11 +866,17 @@ 
 		$writer->write(TJavaScript::renderScriptBlocksCallback($this->_endScripts));
 	}
 
+	/**
+	 * @param THtmlWriter $writer
+	 */
 	public function renderHiddenFieldsBegin($writer)
 	{
 		$this->renderHiddenFieldsInt($writer, true);
 	}
 
+	/**
+	 * @param THtmlWriter $writer
+	 */
 	public function renderHiddenFieldsEnd($writer)
 	{
 		$this->renderHiddenFieldsInt($writer, false);
@@ -886,7 +901,7 @@ 
 	 * Unfortunately this attribute is invalid for hidden fields, so text fields are
 	 * rendered instead (#642).
 	 * @param THtmlWriter $writer writer for the rendering purpose
-	 * @param mixed $initial
+	 * @param boolean $initial
 	 */
 
 	protected function renderHiddenFieldsInt($writer, $initial)

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()
 	{