wikimedia / mediawiki

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
 	 */

includes/parser/LinkHolderArray.php

Doc Comments +3 added lines, -3 removed lines

@@ -57,7 +57,7 @@ 
 	 * serializing at present.
 	 *
 	 * Compact the titles, only serialize the text form.
-	 * @return array
+	 * @return string[]
 	 */
 	public function __sleep() {
 		foreach ( $this->internals as &$nsLinks ) {
@@ -119,8 +119,8 @@ 
 	 * strings will be returned.
 	 *
 	 * @param LinkHolderArray $other
-	 * @param array $texts Array of strings
-	 * @return array
+	 * @param string[] $texts Array of strings
+	 * @return string[]
 	 */
 	public function mergeForeign( $other, $texts ) {
 		$this->tempIdOffset = $idOffset = $this->parent->nextLinkID();

includes/parser/ParserOptions.php

Doc Comments +29 added lines, -1 removed lines

@@ -356,6 +356,9 @@ 
 		return $this->mPreSaveTransform;
 	}
 
+	/**
+	 * @return string
+	 */
 	public function getDateFormat() {
 		$this->optionUsed( 'dateformat' );
 		if ( !isset( $this->mDateFormat ) ) {
@@ -429,6 +432,9 @@ 
 		return wfSetVar( $this->mDateFormat, $x );
 	}
 
+	/**
+	 * @param boolean $x
+	 */
 	public function setEditSection( $x ) {
 		return wfSetVar( $this->mEditSection, $x );
 	}
@@ -445,6 +451,9 @@ 
 		return wfSetVar( $this->mTidy, $x );
 	}
 
+	/**
+	 * @param boolean $x
+	 */
 	public function setInterfaceMessage( $x ) {
 		return wfSetVar( $this->mInterfaceMessage, $x );
 	}
@@ -453,6 +462,9 @@ 
 		return wfSetVar( $this->mTargetLanguage, $x, true );
 	}
 
+	/**
+	 * @param integer $x
+	 */
 	public function setMaxIncludeSize( $x ) {
 		return wfSetVar( $this->mMaxIncludeSize, $x );
 	}
@@ -474,11 +486,18 @@ 
 		return wfSetVar( $this->mExpensiveParserFunctionLimit, $x );
 	}
 
+	/**
+	 * @param boolean $x
+	 */
 	public function setRemoveComments( $x ) {
 		return wfSetVar( $this->mRemoveComments, $x );
 	}
 
 	/* @since 1.24 */
+
+	/**
+	 * @param Closure $x
+	 */
 	public function setCurrentRevisionCallback( $x ) {
 		return wfSetVar( $this->mCurrentRevisionCallback, $x );
 	}
@@ -491,6 +510,9 @@ 
 		return wfSetVar( $this->mEnableLimitReport, $x );
 	}
 
+	/**
+	 * @param string|false $x
+	 */
 	public function setTimestamp( $x ) {
 		return wfSetVar( $this->mTimestamp, $x );
 	}
@@ -531,6 +553,9 @@ 
 		return wfSetVar( $this->mPreSaveTransform, $x );
 	}
 
+	/**
+	 * @param boolean $x
+	 */
 	public function setIsPreview( $x ) {
 		return wfSetVar( $this->mIsPreview, $x );
 	}
@@ -539,6 +564,9 @@ 
 		return wfSetVar( $this->mIsSectionPreview, $x );
 	}
 
+	/**
+	 * @param boolean $x
+	 */
 	public function setIsPrintable( $x ) {
 		return wfSetVar( $this->mIsPrintable, $x );
 	}
@@ -723,7 +751,7 @@ 
 	 * Returns the full array of options that would have been used by
 	 * in 1.16.
 	 * Used to get the old parser cache entries when available.
-	 * @return array
+	 * @return string[]
 	 */
 	public static function legacyOptions() {
 		return array(

includes/parser/StripState.php

Doc Comments +5 added lines, -5 removed lines

@@ -87,7 +87,7 @@ 
 
 	/**
 	 * @param string $text
-	 * @return mixed
+	 * @return string
 	 */
 	public function unstripGeneral( $text ) {
 		return $this->unstripType( 'general', $text );
@@ -95,7 +95,7 @@ 
 
 	/**
 	 * @param string $text
-	 * @return mixed
+	 * @return string
 	 */
 	public function unstripNoWiki( $text ) {
 		return $this->unstripType( 'nowiki', $text );
@@ -103,7 +103,7 @@ 
 
 	/**
 	 * @param string $text
-	 * @return mixed
+	 * @return string
 	 */
 	public function unstripBoth( $text ) {
 		$text = $this->unstripType( 'general', $text );
@@ -114,7 +114,7 @@ 
 	/**
 	 * @param string $type
 	 * @param string $text
-	 * @return mixed
+	 * @return string
 	 */
 	protected function unstripType( $type, $text ) {
 		// Shortcut
@@ -204,7 +204,7 @@ 
 	 *
 	 * @param StripState $otherState
 	 * @param array $texts
-	 * @return array
+	 * @return string[]
 	 */
 	public function merge( $otherState, $texts ) {
 		$mergePrefix = wfRandomString( 16 );

includes/poolcounter/PoolCounterWork.php

Doc Comments +2 added lines, -2 removed lines

@@ -47,7 +47,7 @@ 
 
 	/**
 	 * Retrieve the work from cache
-	 * @return mixed Work result or false
+	 * @return boolean Work result or false
 	 */
 	public function getCachedWork() {
 		return false;
@@ -56,7 +56,7 @@ 
 	/**
 	 * A work not so good (eg. expired one) but better than an error
 	 * message.
-	 * @return mixed Work result or false
+	 * @return boolean Work result or false
 	 */
 	public function fallback() {
 		return false;

includes/Preferences.php

Doc Comments +1 added lines

@@ -1084,6 +1084,7 @@
 
 	/**
 	 * Dummy, kept for backwards-compatibility.
+	 * @param User $user
 	 */
 	static function miscPreferences( $user, IContextSource $context, &$defaultPreferences ) {
 	}

includes/resourceloader/ResourceLoaderImage.php

Doc Comments +1 added lines, -1 removed lines

@@ -312,7 +312,7 @@
 	 * Convert passed image data, which is assumed to be SVG, to PNG.
 	 *
 	 * @param string $svg SVG image data
-	 * @return string|bool PNG image data, or false on failure
+	 * @return string|false PNG image data, or false on failure
 	 */
 	protected function rasterize( $svg ) {
 		/**

includes/revisiondelete/RevDelFileItem.php

Doc Comments +3 added lines

@@ -26,6 +26,9 @@
 	/** @var File */
 	public $file;
 
+	/**
+	 * @param RevDelFileList $list
+	 */
 	public function __construct( $list, $row ) {
 		parent::__construct( $list, $row );
 		$this->file = RepoGroup::singleton()->getLocalRepo()->newFileFromRow( $row );