pradosoft / prado

framework/Web/UI/WebControls/TImageButton.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)
 	{

framework/Web/UI/WebControls/TLinkButton.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)
 	{

framework/Data/ActiveRecord/Relations/TActiveRecordRelation.php

Doc Comments +5 added lines, -1 removed lines

@@ -30,6 +30,9 @@ 
 	private $_context;
 	private $_criteria;
 
+	/**
+	 * @param \Prado\Data\ActiveRecord\TActiveRecordCriteria $criteria
+	 */
 	public function __construct(TActiveRecordRelationContext $context, $criteria)
 	{
 		$this->_context = $context;
@@ -95,7 +98,7 @@ 
 
 	/**
 	 * Fetch results for current relationship.
-	 * @param mixed $obj
+	 * @param TActiveRecord $obj
 	 * @return bool always true.
 	 */
 	public function fetchResultsInto($obj)
@@ -223,6 +226,7 @@ 
 	 * @param array $properties source property names
 	 * @param array &$fkObjects foreign objects
 	 * @param array $fields foreign object field names.
+	 * @param TActiveRecord[] $fkObjects
 	 */
 	protected function populateResult(&$results, $properties, &$fkObjects, $fields)
 	{

framework/I18N/core/MessageCache.php

Doc Comments +1 added lines, -1 removed lines

@@ -109,7 +109,7 @@
 	 * @param string $culture The translation locale, e.g. "en_AU".
 	 * @param int $lastmodified If the source is a file, this file's modified
 	 * time is newer than the cache's modified time, no cache hit.
-	 * @return mixed bool FALSE if no cache hit. Otherwise, translation
+	 * @return false|string bool FALSE if no cache hit. Otherwise, translation
 	 * table data for the specified section and locale.
 	 */
 	public function get($catalogue, $culture, $lastmodified = 0)

framework/Web/Services/TPageService.php

Doc Comments +2 added lines, -2 removed lines

@@ -470,7 +470,7 @@ 
 	 * @param string $pagePath requested page path
 	 * @throws THttpException if requested page path is invalid
 	 * @throws TConfigurationException if the page class cannot be found
-	 * @return TPage the requested page instance
+	 * @return \Prado\TComponent the requested page instance
 	 */
 	protected function createPage($pagePath)
 	{
@@ -517,7 +517,7 @@ 
 
 	/**
 	 * Executes a page.
-	 * @param TPage $page the page instance to be run
+	 * @param \Prado\TComponent $page the page instance to be run
 	 * @param array $properties list of initial page properties
 	 */
 	protected function runPage($page, $properties)

framework/Caching/TCache.php

Doc Comments +2 added lines, -2 removed lines

@@ -146,7 +146,7 @@ 
 	 * @param mixed $value the value to be cached
 	 * @param int $expire the number of seconds in which the cached value will expire. 0 means never expire.
 	 * @param ICacheDependency $dependency dependency of the cached item. If the dependency changes, the item is labeled invalid.
-	 * @return bool true if the value is successfully stored into cache, false otherwise
+	 * @return null|boolean true if the value is successfully stored into cache, false otherwise
 	 */
 	public function set($id, $value, $expire = 0, $dependency = null)
 	{
@@ -283,7 +283,7 @@ 
 	 * Deletes the value with the specified key from cache
 	 * This method is required by the interface \ArrayAccess.
 	 * @param string $id the key of the value to be deleted
-	 * @return bool if no error happens during deletion
+	 * @return boolean|null if no error happens during deletion
 	 */
 	public function offsetUnset($id)
 	{

framework/Exceptions/TErrorHandler.php

Doc Comments +13 added lines, -1 removed lines

@@ -118,7 +118,7 @@ 
 	 * raised in {@link TApplication}.
 	 * The method mainly uses appropriate template to display the error/exception.
 	 * It terminates the application immediately after the error is displayed.
-	 * @param mixed $sender sender of the event
+	 * @param null|\Prado\TApplication $sender sender of the event
 	 * @param mixed $param event parameter (if the event is raised by TApplication, it refers to the exception instance)
 	 */
 	public function handleError($sender, $param)
@@ -244,6 +244,9 @@ 
 		}
 	}
 
+	/**
+	 * @return string
+	 */
 	protected function hidePrivatePathParts($value)
 	{
 		static $aRpl;
@@ -401,6 +404,9 @@ 
 		return $result;
 	}
 
+	/**
+	 * @return string
+	 */
 	private function getExactTraceAsString($exception)
 	{
 		if ($exception instanceof TPhpFatalErrorException &&
@@ -427,6 +433,9 @@ 
 		return $this->hidePrivatePathParts($exception->getTraceAsString());
 	}
 
+	/**
+	 * @param string $pattern
+	 */
 	private function getPropertyAccessTrace($trace, $pattern)
 	{
 		$result = null;
@@ -457,6 +466,9 @@ 
 		return $source;
 	}
 
+	/**
+	 * @param string $message
+	 */
 	private function addLink($message)
 	{
 		if (null !== ($class = $this->getErrorClassNameSpace($message))) {

framework/Web/UI/WebControls/TCaptchaValidator.php

Doc Comments +1 added lines, -1 removed lines

@@ -117,7 +117,7 @@
 
 	/**
 	 * @param string $token
-	 * @return string hash
+	 * @return integer hash
 	 */
 	private function generateTokenHash($token)
 	{

framework/Web/UI/WebControls/TRepeater.php

Doc Comments +4 added lines, -4 removed lines

@@ -286,7 +286,7 @@ 
 	}
 
 	/**
-	 * @param ITemplate $value the template for repeater items
+	 * @param \Prado\Web\UI\TTemplate $value the template for repeater items
 	 * @throws TInvalidDataTypeException if the input is not an {@link ITemplate} or not null.
 	 */
 	public function setItemTemplate($value)
@@ -463,7 +463,7 @@ 
 	 * This method invokes {@link createItem} to create a new repeater item.
 	 * @param int $itemIndex zero-based item index.
 	 * @param TListItemType $itemType item type
-	 * @return TControl the created item, null if item is not created
+	 * @return \Prado\TComponent|null the created item, null if item is not created
 	 */
 	private function createItemInternal($itemIndex, $itemType)
 	{
@@ -483,7 +483,7 @@ 
 	 * @param int $itemIndex zero-based item index.
 	 * @param TListItemType $itemType item type
 	 * @param mixed $dataItem data to be associated with the item
-	 * @return TControl the created item, null if item is not created
+	 * @return \Prado\TComponent|null the created item, null if item is not created
 	 */
 	private function createItemWithDataInternal($itemIndex, $itemType, $dataItem)
 	{
@@ -506,7 +506,7 @@ 
 	 * Creates a repeater item instance based on the item type and index.
 	 * @param int $itemIndex zero-based item index
 	 * @param TListItemType $itemType item type
-	 * @return TControl created repeater item
+	 * @return null|\Prado\TComponent created repeater item
 	 */
 	protected function createItem($itemIndex, $itemType)
 	{