wikimedia / mediawiki

includes/auth/AuthManager.php

Doc Comments +2 added lines, -2 removed lines

@@ -199,8 +199,8 @@
 	 * @deprecated For backwards compatibility only, should be avoided in new code
 	 * @param string $method AuthPlugin method to call
 	 * @param array $params Parameters to pass
-	 * @param mixed $return Return value if AuthPlugin wasn't called
-	 * @return mixed Return value from the AuthPlugin method, or $return
+	 * @param string|null $return Return value if AuthPlugin wasn't called
+	 * @return string Return value from the AuthPlugin method, or $return
 	 */
 	public static function callLegacyAuthPlugin( $method, array $params, $return = null ) {
 		global $wgAuth;

includes/auth/AuthManagerAuthPlugin.php

Doc Comments +3 added lines

@@ -228,6 +228,9 @@
 	/** @var User */
 	private $user;
 
+	/**
+	 * @param User $user
+	 */
 	function __construct( $user ) {
 		$this->user = $user;
 	}

includes/Message.php

Doc Comments +1 added lines, -20 removed lines

@@ -371,8 +371,7 @@ 
 	 *
 	 * @since 1.17
 	 *
-	 * @param string|string[]|MessageSpecifier $key
-	 * @param mixed $param,... Parameters as strings.
+	 * @param string $key
 	 *
 	 * @return Message
 	 */
@@ -415,8 +414,6 @@ 
 	 *
 	 * @since 1.18
 	 *
-	 * @param string|string[] $keys,... Message keys, or first argument as an array of all the
-	 * message keys.
 	 *
 	 * @return Message
 	 */
@@ -487,8 +484,6 @@ 
 	 *
 	 * @since 1.17
 	 *
-	 * @param mixed $params,... Raw parameters as strings, or a single argument that is
-	 * an array of raw parameters.
 	 *
 	 * @return Message $this
 	 */
@@ -509,8 +504,6 @@ 
 	 *
 	 * @since 1.18
 	 *
-	 * @param mixed $param,... Numeric parameters, or a single argument that is
-	 * an array of numeric parameters.
 	 *
 	 * @return Message $this
 	 */
@@ -531,8 +524,6 @@ 
 	 *
 	 * @since 1.22
 	 *
-	 * @param int|int[] $param,... Duration parameters, or a single argument that is
-	 * an array of duration parameters.
 	 *
 	 * @return Message $this
 	 */
@@ -553,8 +544,6 @@ 
 	 *
 	 * @since 1.22
 	 *
-	 * @param string|string[] $param,... Expiry parameters, or a single argument that is
-	 * an array of expiry parameters.
 	 *
 	 * @return Message $this
 	 */
@@ -575,8 +564,6 @@ 
 	 *
 	 * @since 1.22
 	 *
-	 * @param int|int[] $param,... Time period parameters, or a single argument that is
-	 * an array of time period parameters.
 	 *
 	 * @return Message $this
 	 */
@@ -597,8 +584,6 @@ 
 	 *
 	 * @since 1.22
 	 *
-	 * @param int|int[] $param,... Size parameters, or a single argument that is
-	 * an array of size parameters.
 	 *
 	 * @return Message $this
 	 */
@@ -619,8 +604,6 @@ 
 	 *
 	 * @since 1.22
 	 *
-	 * @param int|int[] $param,... Bit rate parameters, or a single argument that is
-	 * an array of bit rate parameters.
 	 *
 	 * @return Message $this
 	 */
@@ -643,8 +626,6 @@ 
 	 *
 	 * @since 1.25
 	 *
-	 * @param string|string[] $param,... plaintext parameters, or a single argument that is
-	 * an array of plaintext parameters.
 	 *
 	 * @return Message $this
 	 */

includes/api/ApiAuthManagerHelper.php

Doc Comments +1 added lines, -2 removed lines

@@ -275,8 +275,6 @@ 
 
 	/**
 	 * Clean up a field array for output
-	 * @param ApiBase $module For context and parameters 'mergerequestfields'
-	 *  and 'messageformat'
 	 * @param array $fields
 	 * @return array
 	 */
@@ -315,6 +313,7 @@ 
 	 * Fetch the standard parameters this helper recognizes
 	 * @param string $action AuthManager action
 	 * @param string $param... Parameters to use
+	 * @param string $param
 	 * @return array
 	 */
 	public static function getStandardParams( $action, $param /* ... */ ) {

includes/cache/CacheDependency.php

Doc Comments +10 added lines, -1 removed lines

@@ -172,7 +172,7 @@ 
 	}
 
 	/**
-	 * @return array
+	 * @return string[]
 	 */
 	function __sleep() {
 		$this->loadDependencyValues();
@@ -228,6 +228,9 @@ 
 	private $name;
 	private $value;
 
+	/**
+	 * @param string $name
+	 */
 	function __construct( $name ) {
 		$this->name = $name;
 		$this->value = $GLOBALS[$name];
@@ -252,6 +255,9 @@ 
 	private $name;
 	private $value;
 
+	/**
+	 * @param string $name
+	 */
 	function __construct( $name ) {
 		$this->name = $name;
 		$this->value = $this->getConfig()->get( $this->name );
@@ -280,6 +286,9 @@ 
 	private $name;
 	private $value;
 
+	/**
+	 * @param string $name
+	 */
 	function __construct( $name ) {
 		$this->name = $name;
 		$this->value = constant( $name );

includes/skins/QuickTemplate.php

Doc Comments +1 added lines

@@ -97,6 +97,7 @@
 	/**
 	 * Main function, used by classes that subclass QuickTemplate
 	 * to show the actual HTML output
+	 * @return string
 	 */
 	abstract public function execute();
 

includes/specials/helpers/LoginHelper.php

Doc Comments +1 added lines, -1 removed lines

@@ -85,7 +85,7 @@
 	}
 
 	/**
-	 * @return array
+	 * @return string[]
 	 */
 	function getOrderFields() {
 		return array( 'rd_namespace', 'rd_title', 'rd_from' );

includes/diff/DairikiDiff.php

Doc Comments +1 added lines, -1 removed lines

@@ -232,7 +232,7 @@
 	 *    $diff = new Diff($lines1, $lines2);
 	 *    $rev = $diff->reverse();
 	 *
-	 * @return Object A Diff object representing the inverse of the
+	 * @return Diff A Diff object representing the inverse of the
 	 *   original diff.
 	 */
 	public function reverse() {

includes/diff/DiffEngine.php

Doc Comments +18 added lines

@@ -222,6 +222,13 @@ 
 		return $ranges;
 	}
 
+	/**
+	 * @param integer $bottoml1
+	 * @param integer $topl1
+	 * @param integer $bottoml2
+	 * @param integer $topl2
+	 * @param integer[] $snake
+	 */
 	private function lcs_rec( $bottoml1, $topl1, $bottoml2, $topl2, &$V, &$snake ) {
 		// check that both sequences are non-empty
 		if ( $bottoml1 > $topl1 || $bottoml2 > $topl2 ) {
@@ -490,6 +497,11 @@ 
 		*/
 	}
 
+	/**
+	 * @param double $M
+	 * @param double $N
+	 * @param double $limit
+	 */
 	private static function findMostProgress( $M, $N, $limit, $V ) {
 		$delta = $N - $M;
 
@@ -609,6 +621,12 @@ 
 	/** @var int */
 	public $rightlength;
 
+	/**
+	 * @param integer $leftstart
+	 * @param integer $leftend
+	 * @param integer $rightstart
+	 * @param integer $rightend
+	 */
 	function __construct( $leftstart, $leftend, $rightstart, $rightend ) {
 		$this->leftstart = $leftstart;
 		$this->leftend = $leftend;