wikimedia / mediawiki

includes/specials/SpecialNewpages.php

Doc Comments +9 added lines

@@ -39,6 +39,9 @@ 
 		parent::__construct( 'Newpages' );
 	}
 
+	/**
+	 * @param string $par
+	 */
 	protected function setup( $par ) {
 		// Options
 		$opts = new FormOptions();
@@ -439,6 +442,9 @@ 
 		return "$sitename - $desc [$code]";
 	}
 
+	/**
+	 * @param null|stdClass $row
+	 */
 	protected function feedItem( $row ) {
 		$title = Title::makeTitle( intval( $row->rc_namespace ), $row->rc_title );
 		if ( $title ) {
@@ -458,6 +464,9 @@ 
 		}
 	}
 
+	/**
+	 * @return string
+	 */
 	protected function feedItemAuthor( $row ) {
 		return isset( $row->rc_user_text ) ? $row->rc_user_text : '';
 	}

includes/specials/SpecialUndelete.php

Doc Comments +17 added lines, -3 removed lines

@@ -39,6 +39,9 @@ 
 	/** @var Config */
 	protected $config;
 
+	/**
+	 * @param null|Title $title
+	 */
 	function __construct( $title, Config $config = null ) {
 		if ( is_null( $title ) ) {
 			throw new MWException( __METHOD__ . ' given a null title.' );
@@ -1028,6 +1031,9 @@ 
 		return true;
 	}
 
+	/**
+	 * @param string|boolean $timestamp
+	 */
 	private function showRevision( $timestamp ) {
 		if ( !preg_match( '/[0-9]{14}/', $timestamp ) ) {
 			return;
@@ -1516,6 +1522,11 @@ 
 		return true;
 	}
 
+	/**
+	 * @param null|stdClass $row
+	 * @param string|null $earliestLiveTime
+	 * @param integer $remaining
+	 */
 	protected function formatRevisionRow( $row, $earliestLiveTime, $remaining ) {
 		$rev = Revision::newFromArchiveRow( $row,
 			[
@@ -1610,6 +1621,9 @@ 
 		return Xml::tags( 'li', $attribs, $revisionRow ) . "\n";
 	}
 
+	/**
+	 * @param null|stdClass $row
+	 */
 	private function formatFileRow( $row ) {
 		$file = ArchivedFile::newFromRow( $row );
 		$ts = wfTimestamp( TS_MW, $row->fa_timestamp );
@@ -1691,7 +1705,7 @@ 
 	/**
 	 * Fetch image view link if it's available to all users
 	 *
-	 * @param File|ArchivedFile $file
+	 * @param ArchivedFile $file
 	 * @param Title $titleObj
 	 * @param string $ts A timestamp
 	 * @param string $key A storage key
@@ -1727,7 +1741,7 @@ 
 	/**
 	 * Fetch file's user id if it's available to this user
 	 *
-	 * @param File|ArchivedFile $file
+	 * @param ArchivedFile $file
 	 * @return string HTML fragment
 	 */
 	function getFileUser( $file ) {
@@ -1750,7 +1764,7 @@ 
 	/**
 	 * Fetch file upload comment if it's available to this user
 	 *
-	 * @param File|ArchivedFile $file
+	 * @param ArchivedFile $file
 	 * @return string HTML fragment
 	 */
 	function getFileComment( $file ) {

includes/user/UserArrayFromResult.php

Doc Comments +1 added lines, -1 removed lines

@@ -40,7 +40,7 @@
 	}
 
 	/**
-	 * @param bool|stdClass $row
+	 * @param null|stdClass $row
 	 * @return void
 	 */
 	protected function setCurrent( $row ) {

maintenance/namespaceDupes.php

Doc Comments +1 added lines, -1 removed lines

@@ -570,8 +570,8 @@
 	/**
 	 * Merge page histories
 	 *
-	 * @param integer $id The page_id
 	 * @param Title $newTitle The new title
+	 * @param stdClass $row
 	 * @return bool
 	 */
 	private function mergePage( $row, Title $newTitle ) {

includes/api/ApiFeedContributions.php

Doc Comments +3 added lines

@@ -447,6 +447,9 @@
 		return $vals;
 	}
 
+	/**
+	 * @param null|stdClass $row
+	 */
 	private function continueStr( $row ) {
 		if ( $this->multiUserMode ) {
 			if ( $this->idMode ) {

includes/api/ApiQueryBacklinksprop.php

Doc Comments +3 added lines

@@ -447,6 +447,9 @@
 		return $vals;
 	}
 
+	/**
+	 * @param null|stdClass $row
+	 */
 	private function continueStr( $row ) {
 		if ( $this->multiUserMode ) {
 			if ( $this->idMode ) {

includes/api/ApiQueryLogEvents.php

Doc Comments +3 added lines

@@ -447,6 +447,9 @@
 		return $vals;
 	}
 
+	/**
+	 * @param null|stdClass $row
+	 */
 	private function continueStr( $row ) {
 		if ( $this->multiUserMode ) {
 			if ( $this->idMode ) {

includes/libs/rdbms/database/DatabasePostgres.php

Doc Comments +12 added lines, -1 removed lines

@@ -59,6 +59,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function hasConstraint( $name ) {
 		$sql = "SELECT 1 FROM pg_catalog.pg_constraint c, pg_catalog.pg_namespace n " .
 			"WHERE c.connamespace = n.oid AND conname = '" .
@@ -1109,6 +1112,10 @@ 
 		return $this->relationExists( $sequence, 'S', $schema );
 	}
 
+	/**
+	 * @param string $table
+	 * @param string $trigger
+	 */
 	function triggerExists( $table, $trigger ) {
 		$q = <<<SQL
 	SELECT 1 FROM pg_class, pg_namespace, pg_trigger
@@ -1132,6 +1139,10 @@ 
 		return $rows;
 	}
 
+	/**
+	 * @param string $table
+	 * @param string $rule
+	 */
 	function ruleExists( $table, $rule ) {
 		$exists = $this->selectField( 'pg_rules', 'rulename',
 			[
@@ -1279,7 +1290,7 @@ 
 	 *
 	 * @param array $options An associative array of options to be turned into
 	 *   an SQL query, valid keys are listed in the function.
-	 * @return array
+	 * @return string[]
 	 */
 	function makeSelectOptions( $options ) {
 		$preLimitTail = $postLimitTail = '';

includes/Title.php

Doc Comments +12 added lines, -13 removed lines

@@ -365,7 +365,7 @@ 
 	 * objects or LinkCache entries. Uses $wgContentHandlerUseDB to determine
 	 * whether to include page_content_model.
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	protected static function getSelectFields() {
 		global $wgContentHandlerUseDB, $wgPageLanguageUseDB;
@@ -558,7 +558,7 @@ 
 	 * Get the prefixed DB key associated with an ID
 	 *
 	 * @param int $id The page_id of the article
-	 * @return Title|null An object representing the article, or null if no such article was found
+	 * @return null|string An object representing the article, or null if no such article was found
 	 */
 	public static function nameOf( $id ) {
 		$dbr = wfGetDB( DB_REPLICA );
@@ -1079,7 +1079,6 @@ 
 	/**
 	 * Returns true if the title is inside one of the specified namespaces.
 	 *
-	 * @param int|int[] $namespaces,... The namespaces to check for
 	 * @return bool
 	 * @since 1.19
 	 */
@@ -1889,7 +1888,7 @@ 
 	 *   - quick  : does cheap permission checks from replica DBs (usable for GUI creation)
 	 *   - full   : does cheap and expensive checks possibly from a replica DB
 	 *   - secure : does cheap and expensive checks, using the master as needed
-	 * @param array $ignoreErrors Array of Strings Set this to a list of message keys
+	 * @param string[] $ignoreErrors Array of Strings Set this to a list of message keys
 	 *   whose corresponding errors may be ignored.
 	 * @return array Array of arrays of the arguments to wfMessage to explain permissions problems.
 	 */
@@ -1990,7 +1989,7 @@ 
 	 * Add the resulting error code to the errors array
 	 *
 	 * @param array $errors List of current errors
-	 * @param array $result Result of errors
+	 * @param string $result Result of errors
 	 *
 	 * @return array List of errors
 	 */
@@ -2385,7 +2384,7 @@ 
 	 *
 	 * @param string $action The action to check
 	 * @param bool $short Short circuit on first error
-	 * @return array List of errors
+	 * @return string[] List of errors
 	 */
 	private function missingPermissionError( $action, $short ) {
 		// We avoid expensive display logic for quickUserCan's and such
@@ -3925,7 +3924,7 @@ 
 	 *
 	 * @param int $revId Revision ID. Get the revision that was before this one.
 	 * @param int $flags Title::GAID_FOR_UPDATE
-	 * @return int|bool Old revision ID, or false if none exists
+	 * @return integer Old revision ID, or false if none exists
 	 */
 	public function getPreviousRevisionID( $revId, $flags = 0 ) {
 		$db = ( $flags & self::GAID_FOR_UPDATE ) ? wfGetDB( DB_MASTER ) : wfGetDB( DB_REPLICA );
@@ -4065,8 +4064,8 @@ 
 	 * Get the number of revisions between the given revision.
 	 * Used for diffs and other things that really need it.
 	 *
-	 * @param int|Revision $old Old revision or rev ID (first before range)
-	 * @param int|Revision $new New revision or rev ID (first after range)
+	 * @param Revision $old Old revision or rev ID (first before range)
+	 * @param Revision $new New revision or rev ID (first after range)
 	 * @param int|null $max Limit of Revisions to count, will be incremented to detect truncations
 	 * @return int Number of revisions between these revisions.
 	 */
@@ -4178,9 +4177,9 @@ 
 	 * Used for diffs and other things that really need it.
 	 *
 	 * @param int|Revision $old Old revision or rev ID (first before range by default)
-	 * @param int|Revision $new New revision or rev ID (first after range by default)
+	 * @param Revision $new New revision or rev ID (first after range by default)
 	 * @param int $limit Maximum number of authors
-	 * @param string|array $options (Optional): Single option, or an array of options:
+	 * @param string $options (Optional): Single option, or an array of options:
 	 *     'include_old' Include $old in the range; $new is excluded.
 	 *     'include_new' Include $new in the range; $old is excluded.
 	 *     'include_both' Include both $old and $new in the range.
@@ -4336,7 +4335,7 @@ 
 	/**
 	 * Get the default message text or false if the message doesn't exist
 	 *
-	 * @return string|bool
+	 * @return false|string
 	 */
 	public function getDefaultMessageText() {
 		global $wgContLang;
@@ -4784,7 +4783,7 @@ 
 	}
 
 	/**
-	 * @return array
+	 * @return string[]
 	 */
 	public function __sleep() {
 		return [