pradosoft / prado

framework/Web/UI/TControl.php

Doc Comments +36 added lines

@@ -261,6 +261,7 @@ 
 	 * Sets the page for a control.
 	 * Only framework developers should use this method.
 	 * @param TPage the page that contains this control
+	 * @param TPage $page
 	 */
 	public function setPage($page)
 	{
@@ -542,6 +543,7 @@ 
 
 	/**
 	 * @param boolean whether the control is visible
+	 * @param boolean $value
 	 */
 	public function setVisible($value)
 	{
@@ -609,6 +611,7 @@ 
 	}
 
 	/**
+	 * @param string $name
 	 * @return boolean whether the named attribute exists
 	 */
 	public function hasAttribute($name)
@@ -620,6 +623,7 @@ 
 	}
 
 	/**
+	 * @param string $name
 	 * @return string attribute value, null if attribute does not exist
 	 */
 	public function getAttribute($name)
@@ -634,6 +638,7 @@ 
 	 * Sets a custom control attribute.
 	 * @param string attribute name
 	 * @param string value of the attribute
+	 * @param string $name
 	 */
 	public function setAttribute($name,$value)
 	{
@@ -671,6 +676,7 @@ 
 
 	/**
 	 * @param boolean set whether to enable viewstate
+	 * @param boolean $value
 	 */
 	public function setEnableViewState($value)
 	{
@@ -687,6 +693,8 @@ 
 	 * that must be kept in controlstate.
 	 * @param string the name of the controlstate value to be returned
 	 * @param mixed the default value. If $key is not found in controlstate, $defaultValue will be returned
+	 * @param string $key
+	 * @param integer $defaultValue
 	 * @return mixed the controlstate value corresponding to $key
 	 */
 	protected function getControlState($key,$defaultValue=null)
@@ -703,6 +711,8 @@ 
 	 * @param string the name of the controlstate value
 	 * @param mixed the controlstate value to be set
 	 * @param mixed default value. If $value===$defaultValue, the item will be cleared from controlstate
+	 * @param string $key
+	 * @param integer $defaultValue
 	 */
 	protected function setControlState($key,$value,$defaultValue=null)
 	{
@@ -726,6 +736,7 @@ 
 	 * When it is false, data saved via setViewState() will not be persisted.
 	 * By default, it is true, meaning data will be persisted across postbacks.
 	 * @param boolean whether data should be persisted
+	 * @param boolean $enabled
 	 */
 	public function trackViewState($enabled)
 	{
@@ -764,6 +775,7 @@ 
 	 * @param string the name of the viewstate value
 	 * @param mixed the viewstate value to be set
 	 * @param mixed default value. If $value===$defaultValue, the item will be cleared from the viewstate.
+	 * @param string $key
 	 */
 	public function setViewState($key,$value,$defaultValue=null)
 	{
@@ -788,6 +800,7 @@ 
 	/**
 	 * Clears a viewstate value.
 	 * @param string the name of the viewstate value to be cleared
+	 * @param string $key
 	 */
 	public function clearViewState($key)
 	{
@@ -893,6 +906,7 @@ 
 	 * Sets a value indicating whether child controls are created.
 	 * If false, any existing child controls will be cleared up.
 	 * @param boolean whether child controls are created
+	 * @param boolean $value
 	 */
 	final protected function setChildControlsCreated($value)
 	{
@@ -983,6 +997,7 @@ 
 	 * Finds all child and grand-child controls that are of the specified type.
 	 * @param string the class name
 	 * @param boolean whether the type comparison is strict or not. If false, controls of the parent classes of the specified class will also be returned.
+	 * @param string $type
 	 * @return array list of controls found
 	 */
 	public function findControlsByType($type,$strict=true)
@@ -1117,6 +1132,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 string $name
 	 * @return mixed the named registered object. Null if object is not found.
 	 */
 	public function getRegisteredObject($name)
@@ -1174,6 +1190,7 @@ 
 	 * Control lifecycles will be caught up during the addition.
 	 * Only framework developers should use this method.
 	 * @param TControl the new child control
+	 * @param TControl $control
 	 */
 	public function addedControl($control)
 	{
@@ -1219,6 +1236,7 @@ 
 	 * Removes a control from the child collection of the control.
 	 * Only framework developers should use this method.
 	 * @param TControl the child control removed
+	 * @param TControl $control
 	 */
 	public function removedControl($control)
 	{
@@ -1470,6 +1488,7 @@ 
 	 * @param string name of the broadcast event
 	 * @param TControl sender of the event
 	 * @param TBroadcastEventParameter event parameter
+	 * @param TBroadcastEventParameter $param
 	 */
 	private function broadcastEventInternal($name,$sender,$param)
 	{
@@ -1694,6 +1713,7 @@ 
 	 * Clears the cached UniqueID.
 	 * If $recursive=true, all children's cached UniqueID will be cleared as well.
 	 * @param boolean whether the clearing is recursive.
+	 * @param boolean $recursive
 	 */
 	private function clearCachedUniqueID($recursive)
 	{
@@ -1731,6 +1751,7 @@ 
 	 * Updates the list of the controls whose IDs are managed by the specified naming container.
 	 * @param TControl the naming container
 	 * @param TControlCollection list of controls
+	 * @param TControl $container
 	 * @throws TInvalidDataValueException if a control's ID is not unique within its naming container.
 	 */
 	private function fillNameTable($container,$controls)
@@ -1900,6 +1921,7 @@ 
 	 * The implementation of this function should raise appropriate event(s) (e.g. OnClick, OnCommand)
 	 * indicating the component is responsible for the postback event.
 	 * @param string the parameter associated with the postback event
+	 * @return void
 	 */
 	public function raisePostBackEvent($param);
 }
@@ -1928,6 +1950,7 @@ 
 	 * Raises postdata changed event.
 	 * The implementation of this function should raise appropriate event(s) (e.g. OnTextChanged)
 	 * indicating the control data is changed.
+	 * @return void
 	 */
 	public function raisePostDataChangedEvent();
 	/**
@@ -1961,6 +1984,7 @@ 
 	public function getIsValid();
 	/**
 	 * @param boolean whether the validator validates successfully
+	 * @return void
 	 */
 	public function setIsValid($value);
 	/**
@@ -1969,6 +1993,7 @@ 
 	public function getErrorMessage();
 	/**
 	 * @param string error message for the validation
+	 * @return void
 	 */
 	public function setErrorMessage($value);
 }
@@ -2036,6 +2061,7 @@ 
 	/**
 	 * Applies this theme to the specified control.
 	 * @param TControl the control to be applied with this theme
+	 * @return boolean
 	 */
 	public function applySkin($control);
 }
@@ -2057,6 +2083,7 @@ 
 	 * Content in the template will be instantiated as components and text strings
 	 * and passed to the specified parent control.
 	 * @param TControl the parent control
+	 * @return void
 	 */
 	public function instantiateIn($parent);
 }
@@ -2081,6 +2108,8 @@ 
 
 	/**
 	 * @param string caption of the button
+	 * @param string $value
+	 * @return void
 	 */
 	public function setText($value);
 
@@ -2091,6 +2120,7 @@ 
 
 	/**
 	 * @param boolean whether postback event trigger by this button will cause input validation
+	 * @return void
 	 */
 	public function setCausesValidation($value);
 
@@ -2101,6 +2131,7 @@ 
 
 	/**
 	 * @param string the command name associated with the {@link onCommand OnCommand} event.
+	 * @return void
 	 */
 	public function setCommandName($value);
 
@@ -2111,6 +2142,7 @@ 
 
 	/**
 	 * @param string the parameter associated with the {@link onCommand OnCommand} event.
+	 * @return void
 	 */
 	public function setCommandParameter($value);
 
@@ -2121,23 +2153,27 @@ 
 
 	/**
 	 * @param string the group of validators which the button causes validation upon postback
+	 * @return void
 	 */
 	public function setValidationGroup($value);
 
 	/**
 	 * Raises <b>OnClick</b> event.
 	 * @param TEventParameter event parameter to be passed to the event handlers
+	 * @return void
 	 */
 	public function onClick($param);
 
 	/**
 	 * Raises <b>OnCommand</b> event.
 	 * @param TCommandEventParameter event parameter to be passed to the event handlers
+	 * @return void
 	 */
 	public function onCommand($param);
 
 	/**
 	 * @param boolean set by a panel to register this button as the default button for the panel.
+	 * @return void
 	 */
 	public function setIsDefaultButton($value);
 

framework/Web/UI/WebControls/TImageButton.php

Doc Comments +5 added lines

@@ -220,6 +220,7 @@ 
 	 * If you override this method, be sure to call the parent implementation
 	 * so that the event handler can be invoked.
 	 * @param TImageClickEventParameter event parameter to be passed to the event handlers
+	 * @param TImageClickEventParameter $param
 	 */
 	public function onClick($param)
 	{
@@ -232,6 +233,7 @@ 
 	 * If you override this method, be sure to call the parent implementation
 	 * so that the event handlers can be invoked.
 	 * @param TCommandEventParameter event parameter to be passed to the event handlers
+	 * @param TCommandEventParameter $param
 	 */
 	public function onCommand($param)
 	{
@@ -324,6 +326,7 @@ 
 
 	/**
 	 * @param string the group of validators which the button causes validation upon postback
+	 * @param string $value
 	 */
 	public function setValidationGroup($value)
 	{
@@ -396,6 +399,8 @@ 
 	 * Constructor.
 	 * @param integer X coordinate of the clicking point
 	 * @param integer Y coordinate of the clicking point
+	 * @param integer $x
+	 * @param integer $y
 	 */
 	public function __construct($x,$y)
 	{

framework/Web/UI/WebControls/TListControl.php

Doc Comments +10 added lines

@@ -347,6 +347,7 @@ 
 	 * An automatic postback to the server will occur whenever the user
 	 * makes change to the list control and then tabs out of it.
 	 * @param boolean the value indicating if postback automatically
+	 * @param boolean $value
 	 */
 	public function setAutoPostBack($value)
 	{
@@ -379,6 +380,7 @@ 
 
 	/**
 	 * @param string the field of the data source that provides the text content of the list items.
+	 * @param string $value
 	 */
 	public function setDataTextField($value)
 	{
@@ -398,6 +400,7 @@ 
 	 * The format string is used in {@link TDataValueFormatter::format()} to format the Text property value
 	 * of each item in the list control.
 	 * @param string the formatting string used to control how data bound to the list control is displayed.
+	 * @param string $value
 	 * @see TDataValueFormatter::format()
 	 */
 	public function setDataTextFormatString($value)
@@ -415,6 +418,7 @@ 
 
 	/**
 	 * @param string the field of the data source that provides the value of each list item.
+	 * @param string $value
 	 */
 	public function setDataValueField($value)
 	{
@@ -856,6 +860,7 @@ 
 	 * as the first and second parameters in {@link sprintf}.
 	 * @param string format string
 	 * @param mixed the data to be formatted
+	 * @param string $formatString
 	 * @return string the formatted result
 	 */
 	protected function formatDataValue($formatString,$value)
@@ -894,28 +899,33 @@ 
 	/**
 	 * Selects an item based on zero-base index on the client side.
 	 * @param integer the index (zero-based) of the item to be selected
+	 * @return void
 	 */
 	public function setSelectedIndex($index);
 	/**
 	 * Selects a list of item based on zero-base indices on the client side.
 	 * @param array list of index of items to be selected
+	 * @return void
 	 */
 	public function setSelectedIndices($indices);
 
 	/**
 	 * Sets selection by item value on the client side.
 	 * @param string the value of the item to be selected.
+	 * @return void
 	 */
 	public function setSelectedValue($value);
 
 	/**
 	 * Sets selection by a list of item values on the client side.
 	 * @param array list of the selected item values
+	 * @return void
 	 */
 	public function setSelectedValues($values);
 
     /**
      * Clears all existing selections on the client side.
+     * @return void
      */
     public function clearSelection();
 }

framework/Web/UI/WebControls/TListItem.php

Doc Comments +3 added lines

@@ -92,6 +92,7 @@ 
 
 	/**
 	 * @param boolean whether the item is enabled
+	 * @param boolean $value
 	 */
 	public function setEnabled($value)
 	{
@@ -108,6 +109,7 @@ 
 
 	/**
 	 * @param boolean whether the item is selected
+	 * @param boolean $value
 	 */
 	public function setSelected($value)
 	{
@@ -184,6 +186,7 @@ 
 	/**
 	 * @param string attribute name
 	 * @param string value of the attribute
+	 * @param string $name
 	 */
 	public function setAttribute($name,$value)
 	{

framework/pradolite.php

Doc Comments +659 added lines

@@ -78,6 +78,10 @@ 
 		}
 		exit(1);
 	}
+
+	/**
+	 * @param TApplication $application
+	 */
 	public static function setApplication($application)
 	{
 		if(self::$_application!==null && !defined('PRADO_TEST_RUN'))
@@ -371,14 +375,26 @@ 
 interface IModule
 {
 	public function init($config);
+
+	/**
+	 * @return string
+	 */
 	public function getID();
 	public function setID($id);
 }
 interface IService
 {
 	public function init($config);
+
+	/**
+	 * @return string
+	 */
 	public function getID();
 	public function setID($id);
+
+	/**
+	 * @return boolean
+	 */
 	public function getEnabled();
 	public function setEnabled($value);
 	public function run();
@@ -390,14 +406,37 @@ 
 }
 interface IUser
 {
+	/**
+	 * @return string
+	 */
 	public function getName();
 	public function setName($value);
+
+	/**
+	 * @return boolean
+	 */
 	public function getIsGuest();
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setIsGuest($value);
 	public function getRoles();
 	public function setRoles($value);
+
+	/**
+	 * @return boolean
+	 */
 	public function isInRole($role);
+
+	/**
+	 * @return string
+	 */
 	public function saveToString();
+
+	/**
+	 * @return TUser
+	 */
 	public function loadFromString($string);
 }
 interface IStatePersister
@@ -409,6 +448,12 @@ 
 {
 	public function get($id);
 	public function set($id,$value,$expire=0,$dependency=null);
+
+	/**
+	 * @param string $id
+	 *
+	 * @return boolean
+	 */
 	public function add($id,$value,$expire=0,$dependency=null);
 	public function delete($id);
 	public function flush();
@@ -427,12 +472,22 @@ 
 }
 interface IStyleable
 {
+	/**
+	 * @return boolean
+	 */
 	public function getHasStyle();
+
+	/**
+	 * @return TStyle
+	 */
 	public function getStyle();
 	public function clearStyle();
 }
 interface IActiveControl
 {
+	/**
+	 * @return TBaseActiveControl
+	 */
 	public function getActiveControl();
 }
 interface ICallbackEventHandler
@@ -442,6 +497,10 @@ 
 interface IDataRenderer
 {
 	public function getData();
+
+	/**
+	 * @param TActiveRecord $value
+	 */
 	public function setData($value);
 }
 class TApplicationComponent extends TComponent
@@ -470,6 +529,10 @@ 
 	{
 		return Prado::getApplication()->getUser();
 	}
+
+	/**
+	 * @param string $assetPath
+	 */
 	public function publishAsset($assetPath,$className=null)
 	{
 		if($className===null)
@@ -478,6 +541,10 @@ 
 		$fullPath=dirname($class->getFileName()).DIRECTORY_SEPARATOR.$assetPath;
 		return $this->publishFilePath($fullPath);
 	}
+
+	/**
+	 * @param string $fullPath
+	 */
 	public function publishFilePath($fullPath, $checkTimestamp=false)
 	{
 		return Prado::getApplication()->getAssetManager()->publishFilePath($fullPath, $checkTimestamp);
@@ -509,6 +576,10 @@ 
 	{
 		return $this->_id;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setID($value)
 	{
 		$this->_id=$value;
@@ -548,6 +619,10 @@ 
 		else
 			throw new TConfigurationException('errorhandler_errortemplatepath_invalid',$value);
 	}
+
+	/**
+	 * @param null|TApplication $sender
+	 */
 	public function handleError($sender,$param)
 	{
 		static $handling=false;
@@ -570,6 +645,10 @@ 
 				$this->handleExternalError(500,$param);
 		}
 	}
+
+	/**
+	 * @return string
+	 */
 	protected static function hideSecurityRelated($value, $exception=null)
 	{
 		$aRpl = array();
@@ -589,6 +668,10 @@ 
 		$aRpl = array_reverse($aRpl, true);
 		return str_replace(array_keys($aRpl), $aRpl, $value);
 	}
+
+	/**
+	 * @param integer $statusCode
+	 */
 	protected function handleExternalError($statusCode,$exception)
 	{
 		if(!($exception instanceof THttpException))
@@ -722,6 +805,10 @@ 
 			return null;
 		return $result;
 	}
+
+	/**
+	 * @param string $pattern
+	 */
 	private function getPropertyAccessTrace($trace,$pattern)
 	{
 		$result=null;
@@ -751,6 +838,10 @@ 
 		}
 		return $source;
 	}
+
+	/**
+	 * @param string $message
+	 */
 	private function addLink($message)
 	{
 		$baseUrl='http://pradosoft.github.io/docs/manual/class-';
@@ -772,6 +863,10 @@ 
 	{
 		return $this->_r;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	protected function setReadOnly($value)
 	{
 		$this->_r=TPropertyValue::ensureBoolean($value);
@@ -1018,9 +1113,27 @@ 
 	{
 		throw new TNotSupportedException('cache_flush_unsupported');
 	}
+
+	/**
+	 * @param string $key
+	 */
 	abstract protected function getValue($key);
+
+	/**
+	 * @param string $key
+	 * @param integer $expire
+	 */
 	abstract protected function setValue($key,$value,$expire);
+
+	/**
+	 * @param string $key
+	 * @param integer $expire
+	 */
 	abstract protected function addValue($key,$value,$expire);
+
+	/**
+	 * @param string $key
+	 */
 	abstract protected function deleteValue($key);
 	public function offsetExists($id)
 	{
@@ -1109,14 +1222,26 @@ 
 	{
 		return $this->generateTimestamps($this->_directory)!=$this->_timestamps;
 	}
+
+	/**
+	 * @param string $fileName
+	 */
 	protected function validateFile($fileName)
 	{
 		return true;
 	}
+
+	/**
+	 * @param string $directory
+	 */
 	protected function validateDirectory($directory)
 	{
 		return true;
 	}
+
+	/**
+	 * @param string $directory
+	 */
 	protected function generateTimestamps($directory,$level=0)
 	{
 		if(($dir=opendir($directory))===false)
@@ -1207,6 +1332,10 @@ 
 		$this->_str='';
 		return $str;
 	}
+
+	/**
+	 * @param string $str
+	 */
 	public function write($str)
 	{
 		$this->_str.=$str;
@@ -1254,6 +1383,10 @@ 
 	{
 		return $this->_dp;
 	}
+
+	/**
+	 * @param integer $value
+	 */
 	protected function setDefaultPriority($value)
 	{
 		$this->_dp=(string)round(TPropertyValue::ensureFloat($value),$this->_p);
@@ -1262,6 +1395,10 @@ 
 	{
 		return $this->_p;
 	}
+
+	/**
+	 * @param integer $value
+	 */
 	protected function setPrecision($value)
 	{
 		$this->_p=TPropertyValue::ensureInteger($value);
@@ -1500,6 +1637,10 @@ 
 		$this->sortPriorities();
 		return $this->_d;
 	}
+
+	/**
+	 * @param integer $priority
+	 */
 	public function toArrayBelowPriority($priority,$inclusive=false)
 	{
 		$this->sortPriorities();
@@ -1512,6 +1653,10 @@ 
 		}
 		return $items;
 	}
+
+	/**
+	 * @param integer $priority
+	 */
 	public function toArrayAbovePriority($priority,$inclusive=true)
 	{
 		$this->sortPriorities();
@@ -1609,6 +1754,10 @@ 
 	{
 		return $this->_r;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	protected function setReadOnly($value)
 	{
 		$this->_r=TPropertyValue::ensureBoolean($value);
@@ -1681,6 +1830,10 @@ 
 		else if($data!==null)
 			throw new TInvalidDataTypeException('map_data_not_iterable');
 	}
+
+	/**
+	 * @param TMap $data
+	 */
 	public function mergeWith($data)
 	{
 		if(is_array($data) || $data instanceof Traversable)
@@ -1732,6 +1885,10 @@ 
 	{
 		return $this->_r;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	protected function setReadOnly($value)
 	{
 		$this->_r=TPropertyValue::ensureBoolean($value);
@@ -1740,6 +1897,10 @@ 
 	{
 		return $this->_dp;
 	}
+
+	/**
+	 * @param integer $value
+	 */
 	protected function setDefaultPriority($value)
 	{
 		$this->_dp = (string)round(TPropertyValue::ensureFloat($value), $this->_p);
@@ -1748,6 +1909,10 @@ 
 	{
 		return $this->_p;
 	}
+
+	/**
+	 * @param integer $value
+	 */
 	protected function setPrecision($value)
 	{
 		$this->_p=TPropertyValue::ensureInteger($value);
@@ -2133,6 +2298,10 @@ 
 	{
 		return $this->_parent;
 	}
+
+	/**
+	 * @param TXmlElement|null $parent
+	 */
 	public function setParent($parent)
 	{
 		$this->_parent=$parent;
@@ -2194,6 +2363,10 @@ 
 		}
 		return null;
 	}
+
+	/**
+	 * @param string $tagName
+	 */
 	public function getElementsByTagName($tagName)
 	{
 		$list=new TList;
@@ -2263,6 +2436,10 @@ 
 	{
 		return $this->_version;
 	}
+
+	/**
+	 * @param string $version
+	 */
 	public function setVersion($version)
 	{
 		$this->_version=$version;
@@ -2271,6 +2448,10 @@ 
 	{
 		return $this->_encoding;
 	}
+
+	/**
+	 * @param string $encoding
+	 */
 	public function setEncoding($encoding)
 	{
 		$this->_encoding=$encoding;
@@ -2341,6 +2522,10 @@ 
 	{
 		return $this->saveToString();
 	}
+
+	/**
+	 * @param DOMElement $node
+	 */
 	protected function buildElement($node)
 	{
 		$element=new TXmlElement($node->tagName);
@@ -2499,10 +2684,18 @@ 
 		}
 		return 0;
 	}
+
+	/**
+	 * @param IUser $user
+	 */
 	private function isUserMatched($user)
 	{
 		return ($this->_everyone || ($this->_guest && $user->getIsGuest()) || ($this->_authenticated && !$user->getIsGuest()) || in_array(strtolower($user->getName()),$this->_users));
 	}
+
+	/**
+	 * @param IUser $user
+	 */
 	private function isRoleMatched($user)
 	{
 		foreach($this->_roles as $role)
@@ -2519,6 +2712,11 @@ 
 }
 class TAuthorizationRuleCollection extends TList
 {
+	/**
+	 * @param IUser $user
+	 * @param string $verb
+	 * @param string $ip
+	 */
 	public function isUserAllowed($user,$verb,$ip)
 	{
 		if($user instanceof IUser)
@@ -2626,6 +2824,10 @@ 
 	{
 		$this->_cryptAlgorithm = $value;
 	}
+
+	/**
+	 * @param string $data
+	 */
 	public function encrypt($data)
 	{
 		$module=$this->openCryptModule();
@@ -2638,6 +2840,10 @@ 
 		mcrypt_module_close($module);
 		return $encrypted;
 	}
+
+	/**
+	 * @param string $data
+	 */
 	public function decrypt($data)
 	{
 		$module=$this->openCryptModule();
@@ -2699,6 +2905,11 @@ 
 	{
 		return $this->_mbstring ? mb_strlen($string,'8bit') : strlen($string);
 	}
+
+	/**
+	 * @param integer $start
+	 * @param integer $length
+	 */
 	private function substr($string,$start,$length)
 	{
 		return $this->_mbstring ? mb_substr($string,$start,$length,'8bit') : substr($string,$start,$length);
@@ -2858,6 +3069,10 @@ 
 		self::checkJsonError();
 		return $s;
 	}
+
+	/**
+	 * @param string $sourceEncoding
+	 */
 	private static function convertToUtf8(&$value, $sourceEncoding) {
 		if(is_string($value))
 			$value=iconv($sourceEncoding, 'UTF-8', $value);
@@ -2867,6 +3082,10 @@ 
 				self::convertToUtf8($element, $sourceEncoding);
 		}
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public static function jsonDecode($value, $assoc = false, $depth = 512)
 	{
 		$s= @json_decode($value, $assoc, $depth);
@@ -2901,6 +3120,10 @@ 
 		}
 		throw new Exception("JSON error ($err): $msg");
 	}
+
+	/**
+	 * @param string $code
+	 */
 	public static function JSMin($code)
 	{
 		Prado::using('System.Web.Javascripts.JSMin');
@@ -3088,6 +3311,10 @@ 
 	{
 		return $this->getID();
 	}
+
+	/**
+	 * @param TUrlManager $manager
+	 */
 	protected function cacheUrlManager($manager)
 	{
 		if($this->getEnableCache())
@@ -3337,6 +3564,10 @@ 
 	{
 		return $_ENV;
 	}
+
+	/**
+	 * @param string $serviceID
+	 */
 	public function constructUrl($serviceID,$serviceParam,$getItems=null,$encodeAmpersand=true,$encodeGetItems=true)
 	{
 		if ($this->_cookieOnly===null)
@@ -3457,6 +3688,10 @@ 
 class THttpCookieCollection extends TList
 {
 	private $_o;
+
+	/**
+	 * @param THttpResponse $owner
+	 */
 	public function __construct($owner=null)
 	{
 		$this->_o=$owner;
@@ -3520,6 +3755,10 @@ 
 	{
 		return $this->_expire;
 	}
+
+	/**
+	 * @param integer $value
+	 */
 	public function setExpire($value)
 	{
 		$this->_expire=TPropertyValue::ensureInteger($value);
@@ -3586,6 +3825,10 @@ 
 	private $_query;
 	private $_fragment;
 	private $_uri;
+
+	/**
+	 * @param string $uri
+	 */
 	public function __construct($uri)
 	{
 		if(($ret=@parse_url($uri))!==false)
@@ -3651,6 +3894,10 @@ 
 class THttpResponseAdapter extends TApplicationComponent
 {
 	private $_response;
+
+	/**
+	 * @param THttpResponse $response
+	 */
 	public function __construct($response)
 	{
 		$this->_response=$response;
@@ -3746,6 +3993,10 @@ 
 	{
 		return $this->_charset;
 	}
+
+	/**
+	 * @param string $charset
+	 */
 	public function setCharset($charset)
 	{
 		$this->_charset = (strToLower($charset) === 'false') ? false : (string)$charset;
@@ -3969,6 +4220,10 @@ 
 			return array_change_key_case($result, $case);
 		return $result;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function appendHeader($value, $replace=true)
 	{
 		header($value, $replace);
@@ -3977,6 +4232,10 @@ 
 	{
 		error_log($message,$messageType,$destination,$extraHeaders);
 	}
+
+	/**
+	 * @param THttpCookie $cookie
+	 */
 	public function addCookie($cookie)
 	{
 		$request=$this->getRequest();
@@ -4034,6 +4293,10 @@ 
 		else
 			return $this->createNewHtmlWriter($type, $this);
 	}
+
+	/**
+	 * @param THttpResponse $writer
+	 */
 	public function createNewHtmlWriter($type, $writer)
 	{
 		return Prado::createComponent($type, $writer);
@@ -4143,6 +4406,10 @@ 
 	{
 		return $this->_customStorage;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setUseCustomStorage($value)
 	{
 		$this->_customStorage=TPropertyValue::ensureBoolean($value);
@@ -4285,10 +4552,18 @@ 
 	{
 		return array_keys($_SESSION);
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function itemAt($key)
 	{
 		return isset($_SESSION[$key]) ? $_SESSION[$key] : null;
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function add($key,$value)
 	{
 		$_SESSION[$key]=$value;
@@ -4395,6 +4670,10 @@ 
 	{
 		return $this->_caseSensitive;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setCaseSensitive($value)
 	{
 		$this->_caseSensitive=TPropertyValue::ensureBoolean($value);
@@ -4407,6 +4686,10 @@ 
 	{
 		parent::add($this->_caseSensitive?$key:strtolower($key),$value);
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function remove($key)
 	{
 		return parent::remove($this->_caseSensitive?$key:strtolower($key));
@@ -4557,6 +4840,10 @@ 
 		}
 		return $this->_page;
 	}
+
+	/**
+	 * @param TPage $page
+	 */
 	public function setPage($page)
 	{
 		$this->_page=$page;
@@ -4700,6 +4987,10 @@ 
 		else
 			return $this->getViewState('Visible',true);
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setVisible($value)
 	{
 		$this->setViewState('Visible',TPropertyValue::ensureBoolean($value),true);
@@ -4738,6 +5029,10 @@ 
 			return $attributes;
 		}
 	}
+
+	/**
+	 * @param string $name
+	 */
 	public function hasAttribute($name)
 	{
 		if($attributes=$this->getViewState('Attributes',null))
@@ -4745,6 +5040,10 @@ 
 		else
 			return false;
 	}
+
+	/**
+	 * @param string $name
+	 */
 	public function getAttribute($name)
 	{
 		if($attributes=$this->getViewState('Attributes',null))
@@ -4752,6 +5051,10 @@ 
 		else
 			return null;
 	}
+
+	/**
+	 * @param string $name
+	 */
 	public function setAttribute($name,$value)
 	{
 		$this->getAttributes()->add($name,$value);
@@ -4775,6 +5078,10 @@ 
 		else
 			return !($this->_flags & self::IS_DISABLE_VIEWSTATE);
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setEnableViewState($value)
 	{
 		if(TPropertyValue::ensureBoolean($value))
@@ -4782,10 +5089,20 @@ 
 		else
 			$this->_flags |= self::IS_DISABLE_VIEWSTATE;
 	}
+
+	/**
+	 * @param string $key
+	 * @param integer $defaultValue
+	 */
 	protected function getControlState($key,$defaultValue=null)
 	{
 		return isset($this->_rf[self::RF_CONTROLSTATE][$key])?$this->_rf[self::RF_CONTROLSTATE][$key]:$defaultValue;
 	}
+
+	/**
+	 * @param string $key
+	 * @param integer $defaultValue
+	 */
 	protected function setControlState($key,$value,$defaultValue=null)
 	{
 		if($value===$defaultValue)
@@ -4797,6 +5114,10 @@ 
 	{
 		unset($this->_rf[self::RF_CONTROLSTATE][$key]);
 	}
+
+	/**
+	 * @param boolean $enabled
+	 */
 	public function trackViewState($enabled)
 	{
 		$this->_trackViewState=TPropertyValue::ensureBoolean($enabled);
@@ -4814,6 +5135,10 @@ 
 		else
 			return $defaultValue;
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function setViewState($key,$value,$defaultValue=null)
 	{
 		if($this->_trackViewState)
@@ -4833,6 +5158,10 @@ 
 				$this->_tempState[$key]=$value;
 		}
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function clearViewState($key)
 	{
 		unset($this->_viewState[$key]);
@@ -4889,6 +5218,10 @@ 
 	{
 		return ($this->_flags & self::IS_CHILD_CREATED)!==0;
 	}
+
+	/**
+	 * @param boolean $value
+	 */
 	final protected function setChildControlsCreated($value)
 	{
 		if($value)
@@ -4948,6 +5281,10 @@ 
 				return null;
 		}
 	}
+
+	/**
+	 * @param string $type
+	 */
 	public function findControlsByType($type,$strict=true)
 	{
 		$controls=array();
@@ -4985,6 +5322,10 @@ 
 		unset($this->_rf[self::RF_NAMED_CONTROLS_ID]);
 		$this->clearNameTable();
 	}
+
+	/**
+	 * @param TCheckBox $object
+	 */
 	public function registerObject($name,$object)
 	{
 		if(isset($this->_rf[self::RF_NAMED_OBJECTS][$name]))
@@ -5019,6 +5360,10 @@ 
 	{
 		return $this->getControlStage() >= self::CS_PRERENDERED;
 	}
+
+	/**
+	 * @param string $name
+	 */
 	public function getRegisteredObject($name)
 	{
 		return isset($this->_rf[self::RF_NAMED_OBJECTS][$name])?$this->_rf[self::RF_NAMED_OBJECTS][$name]:null;
@@ -5042,6 +5387,10 @@ 
 			$control=$control->_parent;
 		return $control===$ancestor;
 	}
+
+	/**
+	 * @param TControl $control
+	 */
 	public function addedControl($control)
 	{
 		if($control->_parent)
@@ -5080,6 +5429,10 @@ 
 			}
 		}
 	}
+
+	/**
+	 * @param TControl $control
+	 */
 	public function removedControl($control)
 	{
 		if($this->_namingContainer)
@@ -5225,6 +5578,10 @@ 
 		$rootControl=(($page=$this->getPage())===null)?$this:$page;
 		$rootControl->broadcastEventInternal($name,$sender,new TBroadcastEventParameter($name,$param));
 	}
+
+	/**
+	 * @param TBroadcastEventParameter $param
+	 */
 	private function broadcastEventInternal($name,$sender,$param)
 	{
 		if($this->hasEvent($name))
@@ -5370,6 +5727,10 @@ 
 		else if($this->_flags & self::IS_STYLESHEET_APPLIED)
 			throw new TInvalidOperationException('control_stylesheet_applied',get_class($this));
 	}
+
+	/**
+	 * @param boolean $recursive
+	 */
 	private function clearCachedUniqueID($recursive)
 	{
 		if($recursive && $this->_uid!==null && isset($this->_rf[self::RF_CONTROLS]))
@@ -5393,6 +5754,10 @@ 
 	{
 		unset($this->_rf[self::RF_NAMED_CONTROLS]);
 	}
+
+	/**
+	 * @param TControl $container
+	 */
 	private function fillNameTable($container,$controls)
 	{
 		foreach($controls as $control)
@@ -5465,11 +5830,18 @@ 
 }
 interface IPostBackEventHandler
 {
+	/**
+	 * @return void
+	 */
 	public function raisePostBackEvent($param);
 }
 interface IPostBackDataHandler
 {
 	public function loadPostData($key,$values);
+
+	/**
+	 * @return void
+	 */
 	public function raisePostDataChangedEvent();
 	public function getDataChanged();
 }
@@ -5477,8 +5849,16 @@ 
 {
 	public function validate();
 	public function getIsValid();
+
+	/**
+	 * @return void
+	 */
 	public function setIsValid($value);
 	public function getErrorMessage();
+
+	/**
+	 * @return void
+	 */
 	public function setErrorMessage($value);
 }
 interface IValidatable
@@ -5493,26 +5873,66 @@ 
 }
 interface ITheme
 {
+	/**
+	 * @return boolean
+	 */
 	public function applySkin($control);
 }
 interface ITemplate
 {
+	/**
+	 * @return void
+	 */
 	public function instantiateIn($parent);
 }
 interface IButtonControl
 {
 	public function getText();
+
+	/**
+	 * @param string $value
+	 *
+	 * @return void
+	 */
 	public function setText($value);
 	public function getCausesValidation();
+
+	/**
+	 * @return void
+	 */
 	public function setCausesValidation($value);
 	public function getCommandName();
+
+	/**
+	 * @return void
+	 */
 	public function setCommandName($value);
 	public function getCommandParameter();
+
+	/**
+	 * @return void
+	 */
 	public function setCommandParameter($value);
 	public function getValidationGroup();
+
+	/**
+	 * @return void
+	 */
 	public function setValidationGroup($value);
+
+	/**
+	 * @return void
+	 */
 	public function onClick($param);
+
+	/**
+	 * @return void
+	 */
 	public function onCommand($param);
+
+	/**
+	 * @return void
+	 */
 	public function setIsDefaultButton($value);
 	public function getIsDefaultButton();
 }
@@ -5970,6 +6390,10 @@ 
 	{
 		return $this->_customStyle===null?'':$this->_customStyle;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setCustomStyle($value)
 	{
 		$this->_customStyle=$value;
@@ -5978,6 +6402,11 @@ 
 	{
 		return isset($this->_fields[$name])?$this->_fields[$name]:'';
 	}
+
+	/**
+	 * @param string $name
+	 * @param string $value
+	 */
 	public function setStyleField($name,$value)
 	{
 		$this->_fields[$name]=$value;
@@ -6473,6 +6902,10 @@ 
 {
 	private $_ensureid=false;
 	protected $_decorator;
+
+	/**
+	 * @param boolean $value
+	 */
 	public function setEnsureId($value)
 	{
 		$this->_ensureid |= TPropertyValue::ensureBoolean($value);
@@ -6562,6 +6995,10 @@ 
 		else
 			return '';
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setForeColor($value)
 	{
 		$this->getStyle()->setForeColor($value);
@@ -6592,6 +7029,10 @@ 
 		else
 			return '';
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setHeight($value)
 	{
 		$this->getStyle()->setHeight($value);
@@ -6653,6 +7094,10 @@ 
 		else
 			return '';
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setWidth($value)
 	{
 		$this->getStyle()->setWidth($value);
@@ -6780,6 +7225,10 @@ 
 			$tpl->instantiateIn($this);
 		}
 	}
+
+	/**
+	 * @param string $id
+	 */
 	public function registerContent($id,TContent $object)
 	{
 		if(isset($this->_contents[$id]))
@@ -6787,6 +7236,10 @@ 
 		else
 			$this->_contents[$id]=$object;
 	}
+
+	/**
+	 * @param string $id
+	 */
 	public function registerContentPlaceHolder($id,TContentPlaceHolder $object)
 	{
 		if(isset($this->_placeholders[$id]))
@@ -6983,6 +7436,10 @@ 
 	{
 		return $this->getViewState('Enctype','');
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setEnctype($value)
 	{
 		$this->setViewState('Enctype',$value,'');
@@ -7102,6 +7559,10 @@ 
 		$scripts = array_unique($scripts);
 		return $scripts;
 	}
+
+	/**
+	 * @param string $base
+	 */
 	protected function getPackagePathUrl($base)
 	{
 		$assets = Prado::getApplication()->getAssetManager();
@@ -7251,6 +7712,11 @@ 
 		$params=func_get_args();
 		$this->_page->registerCachingAction('Page.ClientScript','registerEndScript',$params);
 	}
+
+	/**
+	 * @param string $name
+	 * @param string $value
+	 */
 	public function registerHiddenField($name,$value)
 	{
 		$this->_hiddenFields[$name]=$value;
@@ -7388,6 +7854,10 @@ 
 			$this->renderAllPendingScriptFiles($writer);
 		}
 	}
+
+	/**
+	 * @param boolean $initial
+	 */
 	protected function renderHiddenFieldsInt($writer, $initial)
  	{
 		if ($initial) $this->_renderedHiddenFields = array();
@@ -7423,12 +7893,20 @@ 
 abstract class TClientSideOptions extends TComponent
 {
 	private $_options;
+
+	/**
+	 * @param string $name
+	 */
 	protected function setFunction($name, $code)
 	{
 		if(!TJavaScript::isJsLiteral($code))
 			$code = TJavaScript::quoteJsLiteral($this->ensureFunction($code));
 		$this->setOption($name, $code);
 	}
+
+	/**
+	 * @param string $name
+	 */
 	protected function getOption($name)
 	{
 		if ($this->_options)
@@ -7551,6 +8029,10 @@ 
 		$this->renderControl($writer);
 		$this->unloadRecursive();
 	}
+
+	/**
+	 * @param string $enc
+	 */
 	protected static function decodeUTF8($data, $enc)
 	{
 		if(is_array($data))
@@ -7633,6 +8115,10 @@ 
 		else
 			throw new TInvalidOperationException('page_form_duplicated');
 	}
+
+	/**
+	 * @param string $validationGroup
+	 */
 	public function getValidators($validationGroup=null)
 	{
 		if(!$this->_validators)
@@ -7703,6 +8189,10 @@ 
 	{
 		$this->_styleSheet=empty($value)?null:$value;
 	}
+
+	/**
+	 * @param TControl $control
+	 */
 	public function applyControlSkin($control)
 	{
 		if(($theme=$this->getTheme())!==null)
@@ -7850,6 +8340,10 @@ 
 	{
 		$this->_postBackEventParameter=$value;
 	}
+
+	/**
+	 * @param boolean $beforeLoad
+	 */
 	protected function processPostData($postData,$beforeLoad)
 	{
 		$this->_isLoadingPostData=true;
@@ -7938,6 +8432,10 @@ 
 			$this->getClientScript()->registerFocusControl($lastFocus);
 		$this->_inFormRender=false;
 	}
+
+	/**
+	 * @param TControl $value
+	 */
 	public function setFocus($value)
 	{
 		$this->_focus=$value;
@@ -7983,6 +8481,10 @@ 
 	{
 		return $this->_clientState;
 	}
+
+	/**
+	 * @param string $state
+	 */
 	public function setClientState($state)
 	{
 		$this->_clientState=$state;
@@ -8042,6 +8544,11 @@ 
 	{
 		$this->_pagePath=$value;
 	}
+
+	/**
+	 * @param string $context
+	 * @param string $funcName
+	 */
 	public function registerCachingAction($context,$funcName,$funcParams)
 	{
 		if($this->_cachingStack)
@@ -8064,13 +8571,27 @@ 
 }
 interface IPageStatePersister
 {
+	/**
+	 * @return TPage
+	 */
 	public function getPage();
+
+	/**
+	 * @return void
+	 */
 	public function setPage(TPage $page);
+
+	/**
+	 * @return void
+	 */
 	public function save($state);
 	public function load();
 }
 class TPageStateFormatter
 {
+	/**
+	 * @param TPage $page
+	 */
 	public static function serialize($page,$data)
 	{
 		$sm=$page->getApplication()->getSecurityManager();
@@ -8084,6 +8605,10 @@ 
 			$str=$sm->encrypt($str);
 		return base64_encode($str);
 	}
+
+	/**
+	 * @param TPage $page
+	 */
 	public static function unserialize($page,$data)
 	{
 		$str=base64_decode($data);
@@ -8277,6 +8802,10 @@ 
 	{
 		$this->_cacheModuleID=$value;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setCacheKeyPrefix($value)
 	{
 		$this->_keyPrefix=$value;
@@ -8327,10 +8856,18 @@ 
 	{
 		$this->_cachePostBack=TPropertyValue::ensureBoolean($value);
 	}
+
+	/**
+	 * @param TOutputCacheCheckDependencyEventParameter $param
+	 */
 	public function onCheckDependency($param)
 	{
 		$this->raiseEvent('OnCheckDependency',$this,$param);
 	}
+
+	/**
+	 * @param TOutputCacheCalculateKeyEventParameter $param
+	 */
 	public function onCalculateKey($param)
 	{
 		$this->raiseEvent('OnCalculateKey',$this,$param);
@@ -8422,6 +8959,10 @@ 
 		$tplFile=dirname($class->getFileName()).DIRECTORY_SEPARATOR.$className.self::TEMPLATE_FILE_EXT;
 		return $this->getTemplateByFileName($tplFile);
 	}
+
+	/**
+	 * @param string $fileName
+	 */
 	public function getTemplateByFileName($fileName)
 	{
 		if(($fileName=$this->getLocalizedTemplate($fileName))!==null)
@@ -8461,6 +9002,10 @@ 
 		else
 			return null;
 	}
+
+	/**
+	 * @return string
+	 */
 	protected function getLocalizedTemplate($filename)
 	{
 		if(($app=$this->getApplication()->getGlobalization(false))===null)
@@ -8626,12 +9171,20 @@ 
 				$parentControl->addParsedObject($control);
 		}
 	}
+
+	/**
+	 * @param TControl $control
+	 */
 	protected function configureControl($control,$name,$value)
 	{
 		if(strncasecmp($name,'on',2)===0)					$this->configureEvent($control,$name,$value,$control);
 		else if(($pos=strrpos($name,'.'))===false)				$this->configureProperty($control,$name,$value);
 		else				$this->configureSubProperty($control,$name,$value);
 	}
+
+	/**
+	 * @param TComponent $component
+	 */
 	protected function configureComponent($component,$name,$value)
 	{
 		if(strpos($name,'.')===false)				$this->configureProperty($component,$name,$value);
@@ -8941,6 +9494,11 @@ 
 		$tpl=$objects;
 		return $objects;
 	}
+
+	/**
+	 * @param string $str
+	 * @param string $offset
+	 */
 	protected function parseAttributes($str,$offset)
 	{
 		if($str==='')
@@ -8972,11 +9530,19 @@ 
 		}
 		return $attributes;
 	}
+
+	/**
+	 * @param string $content
+	 */
 	protected function parseTemplateProperty($content,$offset)
 	{
 		$line=$this->_startingLine+count(explode("\n",substr($this->_content,0,$offset)))-1;
 		return array(self::CONFIG_TEMPLATE,new TTemplate($content,$this->_contextPath,$this->_tplFile,$line,false));
 	}
+
+	/**
+	 * @param string $value
+	 */
 	protected function parseAttribute($value)
 	{
 		if(($n=preg_match_all('/<%[#=].*?%>/msS',$value,$matches,PREG_OFFSET_CAPTURE))>0)
@@ -9099,6 +9665,11 @@ 
 	{
 		return $this->_includedFiles;
 	}
+
+	/**
+	 * @param Exception $e
+	 * @param integer $line
+	 */
 	protected function handleException($e,$line,$input=null)
 	{
 		$srcFile=$this->_tplFile;
@@ -9155,6 +9726,10 @@ 
 		}
 		return $input;
 	}
+
+	/**
+	 * @param string $method
+	 */
 	protected function isClassBehaviorMethod(ReflectionClass $class,$method)
 	{
 	  $component=new ReflectionClass('TComponent');
@@ -9237,6 +9812,10 @@ 
 				throw new TInvalidDataValueException('thememanager_basepath_invalid',$value);
 		}
 	}
+
+	/**
+	 * @return string
+	 */
 	public function getBaseUrl()
 	{
 		if($this->_baseUrl===null)
@@ -9635,6 +10214,10 @@ 
 	{
 		return $this->_defaultPage;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setDefaultPage($value)
 	{
 		if($this->_initialized)
@@ -9723,6 +10306,10 @@ 
 			$page->setSubProperty($name,$value);
 		$page->run($this->getResponse()->createHtmlWriter());
 	}
+
+	/**
+	 * @param string $pagePath
+	 */
 	public function constructUrl($pagePath,$getParams=null,$encodeAmpersand=true,$encodeGetItems=true)
 	{
 		return $this->getRequest()->constructUrl($this->getID(),$pagePath,$getParams,$encodeAmpersand,$encodeGetItems);
@@ -9794,11 +10381,20 @@ 
 				throw new TConfigurationException('pageserviceconf_file_invalid',$fname);
 		}
 	}
+
+	/**
+	 * @param string $configPath
+	 */
 	public function loadFromPhp($config,$configPath,$configPagePath)
 	{
 		$this->loadApplicationConfigurationFromPhp($config,$configPath);
 		$this->loadPageConfigurationFromPhp($config,$configPath,$configPagePath);
 	}
+
+	/**
+	 * @param TXmlDocument $dom
+	 * @param string $configPath
+	 */
 	public function loadFromXml($dom,$configPath,$configPagePath)
 	{
 		$this->loadApplicationConfigurationFromXml($dom,$configPath);
@@ -10055,6 +10651,10 @@ 
 		else
 			return $this->_basePath.DIRECTORY_SEPARATOR.$this->hash($path);
 	}
+
+	/**
+	 * @param string $path
+	 */
 	public function getPublishedUrl($path)
 	{
 		$path=realpath($path);
@@ -10063,10 +10663,19 @@ 
 		else
 			return $this->_baseUrl.'/'.$this->hash($path);
 	}
+
+	/**
+	 * @param string $dir
+	 */
 	protected function hash($dir)
 	{
 		return sprintf('%x',crc32($dir.Prado::getVersion()));
 	}
+
+	/**
+	 * @param string $src
+	 * @param string $dst
+	 */
 	protected function copyFile($src,$dst)
 	{
 		if(!is_dir($dst))
@@ -10080,6 +10689,11 @@ 
 			@copy($src,$dstFile);
 		}
 	}
+
+	/**
+	 * @param string $src
+	 * @param string $dst
+	 */
 	public function copyDirectory($src,$dst)
 	{
 		if(!is_dir($dst))
@@ -10109,6 +10723,11 @@ 
 			throw new TInvalidDataValueException('assetmanager_source_directory_invalid', $src);
 		}
 	}
+
+	/**
+	 * @param string $tarfile
+	 * @param string $md5sum
+	 */
 	public function publishTarFile($tarfile, $md5sum, $checkTimestamp=false)
 	{
 		if(isset($this->_published[$md5sum]))
@@ -10131,6 +10750,10 @@ 
 			return $this->_published[$md5sum]=$this->_baseUrl.'/'.$dir;
 		}
 	}
+
+	/**
+	 * @param string $destination
+	 */
 	protected function deployTarFile($path,$destination)
 	{
 		if(($fullpath=realpath($path))===false || !is_file($fullpath))
@@ -10352,6 +10975,10 @@ 
 		$this->_services=array($this->getPageServiceID()=>array('TPageService',array(),null));
 		Prado::setPathOfAlias('Application',$this->_basePath);
 	}
+
+	/**
+	 * @param string $basePath
+	 */
 	protected function resolvePaths($basePath)
 	{
 				if(empty($basePath) || ($basePath=realpath($basePath))===false)
@@ -10417,10 +11044,18 @@ 
 	{
 		return $this->_requestCompleted;
 	}
+
+	/**
+	 * @param integer $defaultValue
+	 */
 	public function getGlobalState($key,$defaultValue=null)
 	{
 		return isset($this->_globals[$key])?$this->_globals[$key]:$defaultValue;
 	}
+
+	/**
+	 * @param string $key
+	 */
 	public function setGlobalState($key,$value,$defaultValue=null,$forceSave=false)
 	{
 		$this->_stateChanged=true;
@@ -10480,6 +11115,10 @@ 
 	{
 		return $this->_basePath;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setBasePath($value)
 	{
 		$this->_basePath=$value;
@@ -10488,6 +11127,10 @@ 
 	{
 		return $this->_configFile;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setConfigurationFile($value)
 	{
 		$this->_configFile=$value;
@@ -10496,6 +11139,10 @@ 
 	{
 		return $this->_configType;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setConfigurationType($value)
 	{
 		$this->_configType = $value;
@@ -10535,6 +11182,10 @@ 
 	{
 		return $this->_runtimePath;
 	}
+
+	/**
+	 * @param string $value
+	 */
 	public function setRuntimePath($value)
 	{
 		$this->_runtimePath=$value;
@@ -10546,6 +11197,10 @@ 
 	{
 		return $this->_service;
 	}
+
+	/**
+	 * @param IService $value
+	 */
 	public function setService($value)
 	{
 		$this->_service=$value;
@@ -10826,6 +11481,10 @@ 
 		else
 			throw new THttpException(500,'application_service_unknown',$serviceID);
 	}
+
+	/**
+	 * @param Exception $param
+	 */
 	public function onError($param)
 	{
 		Prado::log($param->getMessage(),TLogger::ERROR,'System.TApplication');

framework/Xml/TXmlDocument.php

Doc Comments +5 added lines

@@ -66,6 +66,7 @@ 
 
 	/**
 	 * @param TXmlElement parent element of this element
+	 * @param TXmlElement|null $parent
 	 */
 	public function setParent($parent)
 	{
@@ -175,6 +176,7 @@ 
 	}
 
 	/**
+	 * @param string $tagName
 	 * @return TList list of all child elements that have the specified tag-name
 	 */
 	public function getElementsByTagName($tagName)
@@ -334,6 +336,7 @@ 
 
 	/**
 	 * @param string version of this XML document
+	 * @param string $version
 	 */
 	public function setVersion($version)
 	{
@@ -350,6 +353,7 @@ 
 
 	/**
 	 * @param string encoding of this XML document
+	 * @param string $encoding
 	 */
 	public function setEncoding($encoding)
 	{
@@ -473,6 +477,7 @@ 
 	/**
 	 * Recursively converts DOM XML nodes into TXmlElement
 	 * @param DOMXmlNode the node to be converted
+	 * @param DOMElement $node
 	 * @return TXmlElement the converted TXmlElement
 	 */
 	protected function buildElement($node)