wikimedia / mediawiki

includes/api/ApiQueryBase.php

Doc Comments +3 added lines, -3 removed lines

@@ -118,7 +118,7 @@ 
 	 * See ApiQuery::getNamedDB() for more information
 	 * @param string $name Name to assign to the database connection
 	 * @param int $db One of the DB_* constants
-	 * @param array $groups Query groups
+	 * @param string $groups Query groups
 	 * @return DatabaseBase
 	 */
 	public function selectNamedDB( $name, $db, $groups ) {
@@ -552,7 +552,7 @@ 
 
 	/**
 	 * @param string $hash
-	 * @return bool
+	 * @return integer
 	 */
 	public function validateSha1Hash( $hash ) {
 		return preg_match( '/^[a-f0-9]{40}$/', $hash );
@@ -560,7 +560,7 @@ 
 
 	/**
 	 * @param string $hash
-	 * @return bool
+	 * @return integer
 	 */
 	public function validateSha1Base36Hash( $hash ) {
 		return preg_match( '/^[a-z0-9]{31}$/', $hash );

includes/api/ApiQueryCategoryMembers.php

Doc Comments +1 added lines, -1 removed lines

@@ -49,7 +49,7 @@
 
 	/**
 	 * @param string $hexSortkey
-	 * @return bool
+	 * @return integer
 	 */
 	private function validateHexSortkey( $hexSortkey ) {
 		// A hex sortkey has an unbound number of 2 letter pairs

includes/api/ApiQueryExtLinksUsage.php

Doc Comments +3 added lines

@@ -202,6 +202,9 @@
 		return $protocols;
 	}
 
+	/**
+	 * @return string|null
+	 */
 	public static function getProtocolPrefix( $protocol ) {
 		// Find the right prefix
 		global $wgUrlProtocols;

includes/api/ApiQueryImageInfo.php

Doc Comments +3 added lines, -3 removed lines

@@ -325,7 +325,7 @@ 
 	 * allows us to catch certain error conditions early (such as missing
 	 * required parameter).
 	 *
-	 * @param $image File
+	 * @param File $image File
 	 * @param $finalParams array List of parameters to transform image with
 	 */
 	protected function checkParameterNormalise( $image, $finalParams ) {
@@ -700,7 +700,7 @@ 
 	 * Returns all possible parameters to iiprop
 	 *
 	 * @param array $filter List of properties to filter out
-	 * @return array
+	 * @return string[]
 	 */
 	public static function getPropertyNames( $filter = array() ) {
 		return array_keys( self::getPropertyMessages( $filter ) );
@@ -782,7 +782,7 @@ 
 	 * @deprecated since 1.25
 	 * @param array $filter List of properties to filter out
 	 * @param string $modulePrefix
-	 * @return array
+	 * @return string[]
 	 */
 	public static function getPropertyDescriptions( $filter = array(), $modulePrefix = '' ) {
 		return array_merge(

includes/api/ApiResult.php

Doc Comments +4 added lines, -4 removed lines

@@ -469,7 +469,7 @@ 
 	 *
 	 * @since 1.25
 	 * @param array &$arr To add $value to
-	 * @param string|int $name Index of $arr to add $value at.
+	 * @param string $name Index of $arr to add $value at.
 	 * @param mixed $value
 	 * @param int $flags Zero or more OR-ed flags like OVERRIDE | ADD_ON_TOP.
 	 */
@@ -486,10 +486,10 @@ 
 	 *
 	 * @since 1.25
 	 * @param array|string|null $path See ApiResult::addValue()
-	 * @param string|int $name See ApiResult::setValue()
+	 * @param string $name See ApiResult::setValue()
 	 * @param mixed $value
 	 * @param int $flags Zero or more OR-ed flags like OVERRIDE | ADD_ON_TOP.
-	 * @return bool True if $value fits in the result, false if not
+	 * @return boolean|null True if $value fits in the result, false if not
 	 */
 	public function addContentValue( $path, $name, $value, $flags = 0 ) {
 		if ( $name === null ) {
@@ -573,7 +573,7 @@ 
 	 * subelements rather than attributes.
 	 * @since 1.25
 	 * @param array|string|null $path See ApiResult::addValue()
-	 * @param array|string|int $names The element name(s) to be output as subelements
+	 * @param string $names The element name(s) to be output as subelements
 	 */
 	public function addSubelementsList( $path, $names ) {
 		$arr = &$this->path( $path );

includes/api/ApiStashEdit.php

Doc Comments +1 added lines, -1 removed lines

@@ -128,7 +128,7 @@
 	 * @param WikiPage $page
 	 * @param Content $content
 	 * @param User $user
-	 * @return integer ApiStashEdit::ERROR_* constant
+	 * @return string ApiStashEdit::ERROR_* constant
 	 * @since 1.25
 	 */
 	public static function parseAndStash( WikiPage $page, Content $content, User $user ) {

includes/api/ApiTag.php

Doc Comments +3 added lines

@@ -73,6 +73,9 @@
 		return (bool)$result;
 	}
 
+	/**
+	 * @param string $type
+	 */
 	protected function processIndividual( $type, $params, $id ) {
 		$idResult = array( $type => $id );
 

includes/AuthPlugin.php

Doc Comments +4 added lines

@@ -323,6 +323,10 @@
 }
 
 class AuthPluginUser {
+
+	/**
+	 * @param User $user
+	 */
 	function __construct( $user ) {
 		# Override this!
 	}

includes/Block.php

Doc Comments +4 added lines, -4 removed lines

@@ -185,7 +185,7 @@ 
 	/**
 	 * Return the list of ipblocks fields that should be selected to create
 	 * a new block.
-	 * @return array
+	 * @return string[]
 	 */
 	public static function selectFields() {
 		return array(
@@ -1004,7 +1004,7 @@ 
 	/**
 	 * Get a timestamp of the expiry for autoblocks
 	 *
-	 * @param string|int $timestamp
+	 * @param string|false $timestamp
 	 * @return string
 	 */
 	public static function getAutoblockExpiry( $timestamp ) {
@@ -1357,7 +1357,7 @@ 
 	/**
 	 * @since 1.19
 	 *
-	 * @return mixed|string
+	 * @return string
 	 */
 	public function getExpiry() {
 		return $this->mExpiry;
@@ -1373,7 +1373,7 @@ 
 
 	/**
 	 * Get the user who implemented this block
-	 * @return User|string Local User object or string for a foreign user
+	 * @return User Local User object or string for a foreign user
 	 */
 	public function getBlocker() {
 		return $this->blocker;