wikimedia / mediawiki

includes/resourceloader/ResourceLoaderWikiModule.php

Doc Comments +3 added lines, -3 removed lines

@@ -136,14 +136,14 @@ 
 	 * NOTE: This ONLY works for getTitleInfo() and isKnownEmpty(), NOT FOR ANYTHING ELSE.
 	 * In particular, it doesn't work for getContent() or getScript() etc.
 	 *
-	 * @return IDatabase|null
+	 * @return Database|null
 	 */
 	protected function getDB() {
 		return wfGetDB( DB_REPLICA );
 	}
 
 	/**
-	 * @param string $title
+	 * @param string $titleText
 	 * @return null|string
 	 */
 	protected function getContent( $titleText ) {
@@ -336,7 +336,7 @@ 
 	 * @since 1.28
 	 * @param ResourceLoaderContext $context
 	 * @param IDatabase $db
-	 * @param string[] $modules
+	 * @param string[] $moduleNames
 	 */
 	public static function preloadTitleInfo(
 		ResourceLoaderContext $context, IDatabase $db, array $moduleNames

includes/SiteStats.php

Doc Comments +1 added lines, -1 removed lines

@@ -371,7 +371,7 @@
 	 * Do all updates and commit them. More or less a replacement
 	 * for the original initStats, but without output.
 	 *
-	 * @param IDatabase|bool $database
+	 * @param Database|null $database
 	 * - boolean: Whether to use the master DB
 	 * - IDatabase: Database connection to use
 	 * @param array $options Array of options, may contain the following values

includes/specialpage/ChangesListSpecialPage.php

Doc Comments +2 added lines, -2 removed lines

@@ -107,7 +107,7 @@ 
 	/**
 	 * Create a FormOptions object with options as specified by the user
 	 *
-	 * @param array $parameters
+	 * @param string $parameters
 	 *
 	 * @return FormOptions
 	 */
@@ -337,7 +337,7 @@ 
 	/**
 	 * Return a IDatabase object for reading
 	 *
-	 * @return IDatabase
+	 * @return Database|null
 	 */
 	protected function getDB() {
 		return wfGetDB( DB_REPLICA );

includes/specialpage/QueryPage.php

Doc Comments +7 added lines, -4 removed lines

@@ -161,7 +161,7 @@ 
 	 * Subclasses return an array of fields to order by here. Don't append
 	 * DESC to the field names, that'll be done automatically if
 	 * sortDescending() returns true.
-	 * @return array
+	 * @return string[]
 	 * @since 1.18
 	 */
 	function getOrderFields() {
@@ -373,7 +373,7 @@ 
 
 	/**
 	 * Get a DB connection to be used for slow recache queries
-	 * @return IDatabase
+	 * @return Database|null
 	 */
 	function getRecacheDB() {
 		return wfGetDB( DB_REPLICA, [ $this->getName(), 'QueryPage::recache', 'vslow' ] );
@@ -434,7 +434,7 @@ 
 	/**
 	 * Somewhat deprecated, you probably want to be using execute()
 	 * @param int|bool $offset
-	 * @param int|bool $limit
+	 * @param integer $limit
 	 * @return ResultWrapper
 	 */
 	public function doQuery( $offset = false, $limit = false ) {
@@ -775,7 +775,7 @@ 
 	/**
 	 * Override for custom handling. If the titles/links are ok, just do
 	 * feedItemDesc()
-	 * @param object $row
+	 * @param null|stdClass $row
 	 * @return FeedItem|null
 	 */
 	function feedResult( $row ) {
@@ -807,6 +807,9 @@ 
 		return isset( $row->comment ) ? htmlspecialchars( $row->comment ) : '';
 	}
 
+	/**
+	 * @return string
+	 */
 	function feedItemAuthor( $row ) {
 		return isset( $row->user_text ) ? $row->user_text : '';
 	}

includes/specials/pagers/DeletedContribsPager.php

Doc Comments +4 added lines, -1 removed lines

@@ -35,6 +35,9 @@ 
 	 */
 	protected $mNavigationBar;
 
+	/**
+	 * @param string|null $target
+	 */
 	function __construct( IContextSource $context, $target, $namespace = false ) {
 		parent::__construct( $context );
 		$msgs = [ 'deletionlog', 'undeleteviewlink', 'diff' ];
@@ -347,7 +350,7 @@ 
 	/**
 	 * Get the Database object in use
 	 *
-	 * @return IDatabase
+	 * @return Database|null
 	 */
 	public function getDatabase() {
 		return $this->mDb;

includes/specials/SpecialWatchlist.php

Doc Comments +8 added lines, -2 removed lines

@@ -296,6 +296,9 @@ 
 		);
 	}
 
+	/**
+	 * @param FormOptions $opts
+	 */
 	protected function runMainQueryHook( &$tables, &$fields, &$conds, &$query_options,
 		&$join_conds, $opts
 	) {
@@ -310,7 +313,7 @@ 
 	/**
 	 * Return a IDatabase object for reading
 	 *
-	 * @return IDatabase
+	 * @return Database|null
 	 */
 	protected function getDB() {
 		return wfGetDB( DB_REPLICA, 'watchlist' );
@@ -534,6 +537,9 @@ 
 		$this->setBottomText( $opts );
 	}
 
+	/**
+	 * @param FormOptions $options
+	 */
 	function cutoffselector( $options ) {
 		// Cast everything to strings immediately, so that we know all of the values have the same
 		// precision, and can be compared with '==='. 2/24 has a few more decimal places than its
@@ -648,7 +654,7 @@ 
 	 * The assumption made here is that when a subject page is watched a talk page is also watched.
 	 * Hence the number of individual items is halved.
 	 *
-	 * @return int
+	 * @return double
 	 */
 	protected function countItems() {
 		$store = MediaWikiServices::getInstance()->getWatchedItemStore();

includes/user/UserRightsProxy.php

Doc Comments +1 added lines, -1 removed lines

@@ -146,7 +146,7 @@
 	 *
 	 * @param string $database
 	 * @param bool $ignoreInvalidDB If true, don't check if $database is in $wgLocalDatabases
-	 * @return IDatabase|null If invalid selection
+	 * @return Database|null If invalid selection
 	 */
 	public static function getDB( $database, $ignoreInvalidDB = false ) {
 		global $wgDBname;

maintenance/dumpIterator.php

Doc Comments +4 added lines

@@ -152,6 +152,10 @@
 	}
 
 	/* Core function which does whatever the maintenance script is designed to do */
+
+	/**
+	 * @param Database $rev
+	 */
 	abstract public function processRevision( $rev );
 }
 

maintenance/Maintenance.php

Doc Comments +2 added lines, -1 removed lines

@@ -295,7 +295,7 @@ 
 	/**
 	 * Get an argument.
 	 * @param int $argId The integer value (from zero) for the arg
-	 * @param mixed $default The default if it doesn't exist
+	 * @param string $default The default if it doesn't exist
 	 * @return mixed
 	 */
 	protected function getArg( $argId = 0, $default = null ) {
@@ -1344,6 +1344,7 @@ 
 	 * Unlock and lock again
 	 * Since the lock is low-priority, queued reads will be able to complete
 	 * @param Database &$db
+	 * @param Database $db
 	 */
 	private function relockSearchindex( $db ) {
 		$this->unlockSearchindex( $db );