wikimedia / mediawiki

includes/MovePage.php

Doc Comments +3 added lines

@@ -42,6 +42,9 @@
 		$this->newTitle = $newTitle;
 	}
 
+	/**
+	 * @param string $reason
+	 */
 	public function checkPermissions( User $user, $reason ) {
 		$status = new Status();
 

includes/objectcache/ObjectCache.php

Doc Comments +1 added lines, -1 removed lines

@@ -262,7 +262,7 @@
 	}
 
 	/**
-	 * @param array $params [optional] Array key 'fallback' for $fallback.
+	 * @param integer $params [optional] Array key 'fallback' for $fallback.
 	 * @param int|string $fallback Fallback cache, e.g. (CACHE_NONE, "hash") (since 1.24)
 	 * @return BagOStuff
 	 * @deprecated 1.27

includes/objectcache/RedisBagOStuff.php

Doc Comments +2 added lines, -2 removed lines

@@ -307,7 +307,7 @@ 
 
 	/**
 	 * @param string $data
-	 * @return mixed
+	 * @return boolean|string
 	 */
 	protected function unserialize( $data ) {
 		return ctype_digit( $data ) ? intval( $data ) : unserialize( $data );
@@ -316,7 +316,7 @@ 
 	/**
 	 * Get a Redis object with a connection suitable for fetching the specified key
 	 * @param string $key
-	 * @return array (server, RedisConnRef) or (false, false)
+	 * @return false[] (server, RedisConnRef) or (false, false)
 	 */
 	protected function getConnection( $key ) {
 		$candidates = array_keys( $this->serverTagMap );

includes/page/Article.php

Doc Comments +7 added lines, -7 removed lines

@@ -95,7 +95,7 @@ 
 	/**
 	 * Constructor from a page id
 	 * @param int $id Article ID to load
-	 * @return Article|null
+	 * @return Article
 	 */
 	public static function newFromID( $id ) {
 		$t = Title::newFromID( $id );
@@ -353,7 +353,7 @@ 
 	 * @note Code that wants to retrieve page content from the database should
 	 * use WikiPage::getContent().
 	 *
-	 * @return Content|null|bool
+	 * @return null|Content
 	 *
 	 * @since 1.21
 	 */
@@ -441,7 +441,7 @@ 
 	 * on failure.
 	 *
 	 * @since 1.19
-	 * @return Revision|null
+	 * @return Revision
 	 */
 	public function getRevisionFetched() {
 		$this->fetchContentObject();
@@ -1531,7 +1531,7 @@ 
 	 * Chances are you should just be using the ParserOutput from
 	 * WikitextContent::getParserOutput instead of calling this for redirects.
 	 *
-	 * @param Title|array $target Destination(s) to redirect
+	 * @param Title $target Destination(s) to redirect
 	 * @param bool $appendSubtitle [optional]
 	 * @param bool $forceKnown Should the image be shown as a bluelink regardless of existence?
 	 * @return string Containing HTML with redirect link
@@ -2119,7 +2119,7 @@ 
 	 * @param string $reason
 	 * @param int $cascade
 	 * @param array $expiry
-	 * @return bool
+	 * @return Status
 	 */
 	public function updateRestrictions( $limit = array(), $reason = '',
 		&$cascade = 0, $expiry = array()
@@ -2176,7 +2176,7 @@ 
 
 	/**
 	 * @param bool $hasHistory
-	 * @return mixed
+	 * @return false|string
 	 */
 	public function generateReason( &$hasHistory ) {
 		$title = $this->mPage->getTitle();
@@ -2187,7 +2187,7 @@ 
 	// ****** B/C functions for static methods ( __callStatic is PHP>=5.3 ) ****** //
 
 	/**
-	 * @return array
+	 * @return string[]
 	 *
 	 * @deprecated since 1.24, use WikiPage::selectFields() instead
 	 */

includes/page/CategoryPage.php

Doc Comments +1 added lines, -1 removed lines

@@ -41,7 +41,7 @@
 	/**
 	 * Constructor from a page id
 	 * @param int $id Article ID to load
-	 * @return CategoryPage|null
+	 * @return CategoryPage
 	 */
 	public static function newFromID( $id ) {
 		$t = Title::newFromID( $id );

includes/page/WikiFilePage.php

Doc Comments +6 added lines, -3 removed lines

@@ -34,6 +34,9 @@ 
 	protected $mFileLoaded = false;		    // !<
 	protected $mDupes = null;				// !<
 
+	/**
+	 * @param Title $title
+	 */
 	public function __construct( $title ) {
 		parent::__construct( $title );
 		$this->mDupes = null;
@@ -66,7 +69,7 @@ 
 	}
 
 	/**
-	 * @return mixed|null|Title
+	 * @return Title|null
 	 */
 	public function getRedirectTarget() {
 		$this->loadFile();
@@ -120,7 +123,7 @@ 
 	}
 
 	/**
-	 * @return bool|File
+	 * @return File
 	 */
 	public function getFile() {
 		$this->loadFile();
@@ -192,7 +195,7 @@ 
 	 * For foreign API files (InstantCommons), this is not supported currently.
 	 * Results will include hidden categories.
 	 *
-	 * @return TitleArray|Title[]
+	 * @return TitleArrayFromResult|null
 	 * @since 1.23
 	 */
 	public function getForeignCategories() {

includes/pager/TablePager.php

Doc Comments +2 added lines, -2 removed lines

@@ -220,7 +220,7 @@ 
 	 *
 	 * @protected
 	 *
-	 * @param object $row The database result row
+	 * @param stdClass $row The database result row
 	 * @return array Array of attribute => value
 	 */
 	function getRowAttrs( $row ) {
@@ -387,7 +387,7 @@ 
 	 * Resubmits all defined elements of the query string, except for a
 	 * blacklist, passed in the $blacklist parameter.
 	 *
-	 * @param array $blacklist Parameters from the request query which should not be resubmitted
+	 * @param string[] $blacklist Parameters from the request query which should not be resubmitted
 	 * @return string HTML fragment
 	 */
 	function getHiddenFields( $blacklist = array() ) {

includes/parser/CoreParserFunctions.php

Doc Comments +4 added lines, -1 removed lines

@@ -264,6 +264,9 @@ 
 		}
 	}
 
+	/**
+	 * @param string $func
+	 */
 	public static function urlFunction( $func, $s = '', $arg = null ) {
 		$title = Title::newFromText( $s );
 		# Due to order of execution of a lot of bits, the values might be encoded
@@ -521,7 +524,7 @@ 
 	 * to not break PHP 5.3
 	 * @param Parser $parser
 	 * @param string $title
-	 * @return mixed|string
+	 * @return string
 	 */
 	public static function mwnamespace( $parser, $title = null ) {
 		$t = Title::newFromText( $title );

includes/parser/DateFormatter.php

Doc Comments +2 added lines, -2 removed lines

@@ -120,7 +120,7 @@ 
 	/**
 	 * Get a DateFormatter object
 	 *
-	 * @param Language|string|null $lang In which language to format the date
+	 * @param Language $lang In which language to format the date
 	 * 		Defaults to the site content language
 	 * @return DateFormatter
 	 */
@@ -147,7 +147,7 @@ 
 	/**
 	 * @param string $preference User preference
 	 * @param string $text Text to reformat
-	 * @param array $options Array can contain 'linked' and/or 'match-whole'
+	 * @param string[] $options Array can contain 'linked' and/or 'match-whole'
 	 *
 	 * @return string
 	 */