wikimedia / mediawiki

includes/logging/PatrolLog.php

Doc Comments +1 added lines, -1 removed lines

@@ -30,7 +30,7 @@
 	/**
 	 * Record a log event for a change being patrolled
 	 *
-	 * @param int|RecentChange $rc Change identifier or RecentChange object
+	 * @param RecentChange $rc Change identifier or RecentChange object
 	 * @param bool $auto Was this patrol event automatic?
 	 * @param User $user User performing the action or null to use $wgUser
 	 * @param string|string[] $tags Change tags to add to the patrol log entry

maintenance/findHooks.php

Doc Comments +1 added lines, -1 removed lines

@@ -296,7 +296,7 @@
 	/**
 	 * Get hooks from a directory of PHP files.
 	 * @param string $dir Directory path to start at
-	 * @param int $recursive Pass self::FIND_RECURSIVE
+	 * @param int $recurse Pass self::FIND_RECURSIVE
 	 * @return array Array: key => hook name; value => array of arguments or string 'unknown'
 	 */
 	private function getHooksFromDir( $dir, $recurse = 0 ) {

includes/db/DatabaseMysqlBase.php

Doc Comments +12 added lines, -6 removed lines

@@ -228,7 +228,7 @@ 
 
 	/**
 	 * @param ResultWrapper|resource $res
-	 * @return stdClass|bool
+	 * @return stdClass
 	 * @throws DBUnexpectedError
 	 */
 	function fetchObject( $res ) {
@@ -363,7 +363,7 @@ 
 	/**
 	 * Get the name of the specified field in a result
 	 *
-	 * @param ResultWrapper|resource $res
+	 * @param resource $res
 	 * @param int $n
 	 * @return string
 	 */
@@ -386,7 +386,7 @@ 
 	/**
 	 * Get the type of the specified field in a result
 	 *
-	 * @param ResultWrapper|resource $res
+	 * @param resource $res
 	 * @param int $n
 	 * @return string
 	 */
@@ -408,7 +408,7 @@ 
 	/**
 	 * Move internal result pointer
 	 *
-	 * @param ResultWrapper|resource $res
+	 * @param resource $res
 	 * @param int $row
 	 * @return bool
 	 */
@@ -802,7 +802,7 @@ 
 	/**
 	 * Get the position of the master from SHOW SLAVE STATUS
 	 *
-	 * @return MySQLMasterPos|bool
+	 * @return DBMasterPos
 	 */
 	function getSlavePos() {
 		$res = $this->query( 'SHOW SLAVE STATUS', 'DatabaseBase::getSlavePos' );
@@ -966,6 +966,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $lockName
+	 */
 	private function makeLockName( $lockName ) {
 		// http://dev.mysql.com/doc/refman/5.7/en/miscellaneous-functions.html#function_get-lock
 		// Newer version enforce a 64 char length limit.
@@ -1321,6 +1324,9 @@ 
 		$is_pk, $is_unique, $is_multiple, $is_key, $type, $binary,
 		$is_numeric, $is_blob, $is_unsigned, $is_zerofill;
 
+	/**
+	 * @param stdClass $info
+	 */
 	function __construct( $info ) {
 		$this->name = $info->name;
 		$this->tablename = $info->table;
@@ -1467,7 +1473,7 @@ 
 	}
 
 	/**
-	 * @return string|bool
+	 * @return string|false
 	 */
 	protected function getBinlogName() {
 		$m = [];

includes/jobqueue/JobQueueDB.php

Doc Comments +6 added lines, -6 removed lines

@@ -314,7 +314,7 @@ 
 	 * @param string $uuid 32 char hex string
 	 * @param int $rand Random unsigned integer (31 bits)
 	 * @param bool $gte Search for job_random >= $random (otherwise job_random <= $random)
-	 * @return stdClass|bool Row|false
+	 * @return boolean Row|false
 	 */
 	protected function claimRandom( $uuid, $rand, $gte ) {
 		$dbw = $this->getMasterDB();
@@ -391,7 +391,7 @@ 
 	 * Reserve a row with a single UPDATE without holding row locks over RTTs...
 	 *
 	 * @param string $uuid 32 char hex string
-	 * @return stdClass|bool Row|false
+	 * @return boolean Row|false
 	 */
 	protected function claimOldest( $uuid ) {
 		$dbw = $this->getMasterDB();
@@ -545,7 +545,7 @@ 
 
 	/**
 	 * @see JobQueue::getAllQueuedJobs()
-	 * @return Iterator
+	 * @return MappedIterator|null
 	 */
 	public function getAllQueuedJobs() {
 		return $this->getJobIterator( [ 'job_cmd' => $this->getType(), 'job_token' => '' ] );
@@ -553,7 +553,7 @@ 
 
 	/**
 	 * @see JobQueue::getAllAcquiredJobs()
-	 * @return Iterator
+	 * @return MappedIterator|null
 	 */
 	public function getAllAcquiredJobs() {
 		return $this->getJobIterator( [ 'job_cmd' => $this->getType(), "job_token > ''" ] );
@@ -561,7 +561,7 @@ 
 
 	/**
 	 * @param array $conds Query conditions
-	 * @return Iterator
+	 * @return MappedIterator|null
 	 */
 	protected function getJobIterator( array $conds ) {
 		$dbr = $this->getSlaveDB();
@@ -813,7 +813,7 @@ 
 	/**
 	 * Return the list of job fields that should be selected.
 	 * @since 1.23
-	 * @return array
+	 * @return string[]
 	 */
 	public static function selectFields() {
 		return [

includes/WatchedItemStore.php

Doc Comments +5 added lines

@@ -410,6 +410,11 @@
 		return true;
 	}
 
+	/**
+	 * @param WatchedItem|null $item
+	 * @param string $force
+	 * @param integer $oldid
+	 */
 	private function getNotificationTimestamp( User $user, Title $title, $item, $force, $oldid ) {
 		if ( !$oldid ) {
 			// No oldid given, assuming latest revision; clear the timestamp.

includes/filerepo/file/LocalFile.php

Doc Comments +6 added lines, -6 removed lines

@@ -187,7 +187,7 @@ 
 
 	/**
 	 * Fields in the image table
-	 * @return array
+	 * @return string[]
 	 */
 	static function selectFields() {
 		return [
@@ -1108,11 +1108,11 @@ 
 
 	/**
 	 * Upload a file and record it in the DB
-	 * @param string|FSFile $src Source storage path, virtual URL, or filesystem path
+	 * @param string $src Source storage path, virtual URL, or filesystem path
 	 * @param string $comment Upload description
 	 * @param string $pageText Text to use for the new description page,
 	 *   if a new description page is created
-	 * @param int|bool $flags Flags for publish()
+	 * @param integer $flags Flags for publish()
 	 * @param array|bool $props File properties, if known. This can be used to
 	 *   reduce the upload time when uploading virtual URLs for which the file
 	 *   info is already known
@@ -1799,7 +1799,7 @@ 
 	 * it skips the parser cache.
 	 *
 	 * @param Language $lang What language to get description in (Optional)
-	 * @return bool|mixed
+	 * @return false|string
 	 */
 	function getDescriptionText( $lang = null ) {
 		$revision = Revision::newFromTitle( $this->title, false, Revision::READ_NORMAL );
@@ -1834,7 +1834,7 @@ 
 	}
 
 	/**
-	 * @return bool|string
+	 * @return string
 	 */
 	function getTimestamp() {
 		$this->load();
@@ -1843,7 +1843,7 @@ 
 	}
 
 	/**
-	 * @return bool|string
+	 * @return string|false
 	 */
 	public function getDescriptionTouched() {
 		// The DB lookup might return false, e.g. if the file was just deleted, or the shared DB repo

includes/filerepo/FileRepo.php

Doc Comments +5 added lines, -5 removed lines

@@ -220,7 +220,7 @@ 
 	 * Get an explanatory message if this repo is read-only.
 	 * This checks if an administrator disabled writes to the backend.
 	 *
-	 * @return string|bool Returns false if the repo is not read-only
+	 * @return string|false Returns false if the repo is not read-only
 	 */
 	public function getReadOnlyReason() {
 		return $this->backend->getReadOnlyReason();
@@ -716,7 +716,7 @@ 
 	 *
 	 * @param string $query Query string to append
 	 * @param string $entry Entry point; defaults to index
-	 * @return string|bool False on failure
+	 * @return string|false False on failure
 	 */
 	public function makeUrl( $query = '', $entry = 'index' ) {
 		if ( isset( $this->scriptDirUrl ) ) {
@@ -797,7 +797,7 @@ 
 	/**
 	 * Get the URL of the stylesheet to apply to description pages
 	 *
-	 * @return string|bool False on failure
+	 * @return string|false False on failure
 	 */
 	public function getDescriptionStylesheetUrl() {
 		if ( isset( $this->scriptDirUrl ) ) {
@@ -958,7 +958,7 @@ 
 	 *
 	 * @param string|FSFile $src Source file system path, storage path, or virtual URL
 	 * @param string $dst Virtual URL or storage path
-	 * @param array|string|null $options An array consisting of a key named headers
+	 * @param string $options An array consisting of a key named headers
 	 *   listing extra headers. If a string, taken as content-disposition header.
 	 *   (Support for array of options new in 1.23)
 	 * @return FileRepoStatus
@@ -1158,7 +1158,7 @@ 
 	 * Options to $options include:
 	 *   - headers : name/value map of HTTP headers to use in response to GET/HEAD requests
 	 *
-	 * @param string|FSFile $src The source file system path, storage path, or URL
+	 * @param string $src The source file system path, storage path, or URL
 	 * @param string $dstRel The destination relative path
 	 * @param string $archiveRel The relative path where the existing file is to
 	 *   be archived, if there is one. Relative to the public zone root.

languages/Language.php

Doc Comments +17 added lines, -15 removed lines

@@ -738,7 +738,7 @@ 
 	}
 
 	/**
-	 * @return array|string
+	 * @return string
 	 */
 	function getDefaultDateFormat() {
 		$df = self::$dataCache->getItem( $this->mCode, 'defaultDateFormat' );
@@ -922,7 +922,7 @@ 
 	}
 
 	/**
-	 * @return array
+	 * @return string[]
 	 */
 	function getMonthNamesArray() {
 		$monthNames = [ '' ];
@@ -949,7 +949,7 @@ 
 	}
 
 	/**
-	 * @return array
+	 * @return string[]
 	 */
 	function getMonthAbbreviationsArray() {
 		$monthNames = [ '' ];
@@ -1011,7 +1011,7 @@ 
 	 * Pass through result from $dateTimeObj->format()
 	 * @param DateTime|bool|null &$dateTimeObj
 	 * @param string $ts
-	 * @param DateTimeZone|bool|null $zone
+	 * @param null|DateTimeZone $zone
 	 * @param string $code
 	 * @return string
 	 */
@@ -1808,7 +1808,7 @@ 
 	 *
 	 * @param int $year
 	 *
-	 * @return string
+	 * @return integer
 	 */
 	private static function hebrewYearStart( $year ) {
 		$a = intval( ( 12 * ( $year - 1 ) + 17 ) % 19 );
@@ -2596,7 +2596,7 @@ 
 
 	/**
 	 * @param array $matches
-	 * @return mixed|string
+	 * @return string
 	 */
 	function ucwordbreaksCallbackAscii( $matches ) {
 		return $this->ucfirst( $matches[1] );
@@ -2699,7 +2699,7 @@ 
 
 	/**
 	 * @param string $str
-	 * @return mixed|string
+	 * @return string
 	 */
 	function lcfirst( $str ) {
 		$o = ord( $str );
@@ -2718,7 +2718,7 @@ 
 	/**
 	 * @param string $str
 	 * @param bool $first
-	 * @return mixed|string
+	 * @return string
 	 */
 	function lc( $str, $first = false ) {
 		if ( function_exists( 'mb_strtolower' ) ) {
@@ -2755,7 +2755,7 @@ 
 
 	/**
 	 * @param string $str
-	 * @return mixed|string
+	 * @return string
 	 */
 	function ucwords( $str ) {
 		if ( $this->isMultibyte( $str ) ) {
@@ -2787,7 +2787,7 @@ 
 	 * capitalize words at word breaks
 	 *
 	 * @param string $str
-	 * @return mixed
+	 * @return string
 	 */
 	function ucwordbreaks( $str ) {
 		if ( $this->isMultibyte( $str ) ) {
@@ -2858,7 +2858,7 @@ 
 	}
 
 	/**
-	 * @return array
+	 * @return string
 	 */
 	function fallback8bitEncoding() {
 		return self::$dataCache->getItem( $this->mCode, 'fallback8bitEncoding' );
@@ -4154,6 +4154,8 @@ 
 	 * @param Title &$nt The title object of the link
 	 * @param bool $ignoreOtherCond To disable other conditions when
 	 *   we need to transclude a template or update a category's link
+	 * @param string $link
+	 * @param Title $nt
 	 */
 	public function findVariantLink( &$link, &$nt, $ignoreOtherCond = false ) {
 		$this->mConverter->findVariantLink( $link, $nt, $ignoreOtherCond );
@@ -4469,7 +4471,7 @@ 
 
 	/**
 	 * @param string $talk
-	 * @return mixed
+	 * @return string
 	 */
 	function fixVariableInNamespace( $talk ) {
 		if ( strpos( $talk, '$1' ) === false ) {
@@ -4545,7 +4547,7 @@ 
 
 	/**
 	 * @todo Document
-	 * @param int|float $seconds
+	 * @param double $seconds
 	 * @param array $format Optional
 	 *   If $format['avoid'] === 'avoidseconds': don't mention seconds if $seconds >= 1 hour.
 	 *   If $format['avoid'] === 'avoidminutes': don't mention seconds/minutes if $seconds > 48 hours.
@@ -4714,7 +4716,7 @@ 
 	 * @param string $details HTML safe text between brackets
 	 * @param bool $oppositedm Add the direction mark opposite to your
 	 *   language, to display text properly
-	 * @return HTML escaped string
+	 * @return string escaped string
 	 */
 	function specialList( $page, $details, $oppositedm = true ) {
 		if ( !$details ) {
@@ -4799,7 +4801,7 @@ 
 	/**
 	 * Get the conversion rule title, if any.
 	 *
-	 * @return string
+	 * @return boolean
 	 */
 	public function getConvRuleTitle() {
 		return $this->mConverter->getConvRuleTitle();

includes/filebackend/TempFSFile.php

Doc Comments +3 added lines

@@ -34,6 +34,9 @@
 	/** @var array Map of (path => 1) for paths to delete on shutdown */
 	protected static $pathsCollect = null;
 
+	/**
+	 * @param string|false $path
+	 */
 	public function __construct( $path ) {
 		parent::__construct( $path );