wikimedia / mediawiki

includes/cache/LinkCache.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/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/Status.php

Doc Comments +3 added lines, -3 removed lines

@@ -434,7 +434,7 @@ 
 	/**
 	 * Returns true if the specified message is present as a warning or error
 	 *
-	 * @param string|Message $message Message key or object to search for
+	 * @param string $message Message key or object to search for
 	 *
 	 * @return bool
 	 */
@@ -449,8 +449,8 @@ 
 	 * Note, due to the lack of tools for comparing Message objects, this
 	 * function will not work when using a Message object as the search parameter.
 	 *
-	 * @param Message|string $source Message key or object to search for
-	 * @param Message|string $dest Replacement message key or object
+	 * @param string $source Message key or object to search for
+	 * @param string $dest Replacement message key or object
 	 * @return bool Return true if the replacement was done, false otherwise.
 	 */
 	public function replaceMessage( $source, $dest ) {

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/libs/StatusValue.php

Doc Comments +2 added lines, -2 removed lines

@@ -139,7 +139,7 @@ 
 	/**
 	 * Add a new warning
 	 *
-	 * @param string|MessageSpecifier $message Message key or object
+	 * @param Message $message Message key or object
 	 */
 	public function warning( $message /*, parameters... */ ) {
 		$this->errors[] = [
@@ -167,7 +167,7 @@ 
 	 * Add an error and set OK to false, indicating that the operation
 	 * as a whole was fatal
 	 *
-	 * @param string|MessageSpecifier $message Message key or object
+	 * @param string $message Message key or object
 	 */
 	public function fatal( $message /*, parameters... */ ) {
 		$this->errors[] = [

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();