wikimedia / mediawiki

includes/deferred/SiteStatsUpdate.php

Doc Comments +6 added lines

@@ -38,6 +38,12 @@
 	protected $images = 0;
 
 	// @todo deprecate this constructor
+
+	/**
+	 * @param integer $views
+	 * @param integer $edits
+	 * @param integer $good
+	 */
 	function __construct( $views, $edits, $good, $pages = 0, $users = 0 ) {
 		$this->edits = $edits;
 		$this->articles = $good;

includes/diff/DairikiDiff.php

Doc Comments +2 added lines, -1 removed lines

@@ -590,6 +590,7 @@ 
 	 * to be the "change".
 	 *
 	 * This is extracted verbatim from analyze.c (GNU diffutils-2.7).
+	 * @param string[] $lines
 	 */
 	private function shiftBoundaries( $lines, &$changed, $other_changed ) {
 		$i = 0;
@@ -750,7 +751,7 @@ 
 	 *    $diff = new Diff($lines1, $lines2);
 	 *    $rev = $diff->reverse();
 	 *
-	 * @return Object A Diff object representing the inverse of the
+	 * @return Diff A Diff object representing the inverse of the
 	 *   original diff.
 	 */
 	public function reverse() {

includes/diff/DifferenceEngine.php

Doc Comments +6 added lines, -6 removed lines

@@ -104,7 +104,7 @@ 
 	 * Constructor
 	 * @param IContextSource $context Context to use, anything else will be ignored
 	 * @param int $old Old ID we want to show and diff with.
-	 * @param string|int $new Either revision ID or 'prev' or 'next'. Default: 0.
+	 * @param integer $new Either revision ID or 'prev' or 'next'. Default: 0.
 	 * @param int $rcid Deprecated, no longer used!
 	 * @param bool $refreshCache If set, refreshes the diff cache
 	 * @param bool $unhide If set, allow viewing deleted revs
@@ -160,7 +160,7 @@ 
 	}
 
 	/**
-	 * @return bool|int
+	 * @return integer
 	 */
 	public function getNewid() {
 		$this->loadRevisionIds();
@@ -174,7 +174,7 @@ 
 	 *
 	 * @param int $id Revision ID
 	 *
-	 * @return mixed URL or false
+	 * @return string|false URL or false
 	 */
 	public function deletedLink( $id ) {
 		if ( $this->getUser()->isAllowed( 'deletedhistory' ) ) {
@@ -675,7 +675,7 @@ 
 	 * @param string|bool $ntitle Header for new text or false
 	 * @param string $notice HTML between diff header and body
 	 *
-	 * @return mixed
+	 * @return false|string
 	 */
 	public function getDiff( $otitle, $ntitle, $notice = '' ) {
 		$body = $this->getDiffBody();
@@ -697,7 +697,7 @@ 
 	/**
 	 * Get the diff table body, without header
 	 *
-	 * @return mixed (string/false)
+	 * @return false|string (string/false)
 	 */
 	public function getDiffBody() {
 		$this->mCacheHit = true;
@@ -931,7 +931,7 @@ 
 	 *
 	 * @param string $text
 	 *
-	 * @return mixed
+	 * @return string
 	 */
 	public function localiseLineNumbers( $text ) {
 		return preg_replace_callback(

includes/diff/WikiDiff3.php

Doc Comments +18 added lines

@@ -222,6 +222,13 @@ 
 		return $ranges;
 	}
 
+	/**
+	 * @param integer $bottoml1
+	 * @param integer $topl1
+	 * @param integer $bottoml2
+	 * @param integer $topl2
+	 * @param integer[] $snake
+	 */
 	private function lcs_rec( $bottoml1, $topl1, $bottoml2, $topl2, &$V, &$snake ) {
 		// check that both sequences are non-empty
 		if ( $bottoml1 > $topl1 || $bottoml2 > $topl2 ) {
@@ -490,6 +497,11 @@ 
 		*/
 	}
 
+	/**
+	 * @param double $M
+	 * @param double $N
+	 * @param double $limit
+	 */
 	private static function findMostProgress( $M, $N, $limit, $V ) {
 		$delta = $N - $M;
 
@@ -609,6 +621,12 @@ 
 	/** @var int */
 	public $rightlength;
 
+	/**
+	 * @param integer $leftstart
+	 * @param integer $leftend
+	 * @param integer $rightstart
+	 * @param integer $rightend
+	 */
 	function __construct( $leftstart, $leftend, $rightstart, $rightend ) {
 		$this->leftstart = $leftstart;
 		$this->leftend = $leftend;

includes/exception/BadTitleError.php

Doc Comments +1 added lines, -1 removed lines

@@ -28,7 +28,7 @@
  */
 class BadTitleError extends ErrorPageError {
 	/**
-	 * @param string|Message|MalformedTitleException $msg A message key (default: 'badtitletext'), or
+	 * @param MalformedTitleException $msg A message key (default: 'badtitletext'), or
 	 *     a MalformedTitleException to figure out things from
 	 * @param array $params Parameter to wfMessage()
 	 */

includes/exception/MWException.php

Doc Comments +4 added lines

@@ -265,6 +265,10 @@
 			header( $header );
 		}
 	}
+
+	/**
+	 * @param integer $code
+	 */
 	private static function statusHeader( $code ) {
 		if ( !headers_sent() ) {
 			HttpStatus::header( $code );

includes/exception/MWExceptionHandler.php

Doc Comments +1 added lines, -1 removed lines

@@ -159,7 +159,7 @@
 	 *   }
 	 *
 	 * @since 1.25
-	 * @param Exception|Throwable $e
+	 * @param Exception $e
 	 */
 	public static function handleException( $e ) {
 		try {

includes/export/DumpFileOutput.php

Doc Comments +2 added lines, -2 removed lines

@@ -73,7 +73,7 @@ 
 	}
 
 	/**
-	 * @param array $newname
+	 * @param string $newname
 	 * @return string
 	 * @throws MWException
 	 */
@@ -107,7 +107,7 @@ 
 	}
 
 	/**
-	 * @return string|null
+	 * @return string
 	 */
 	function getFilenames() {
 		return $this->filename;

includes/export/DumpOutput.php

Doc Comments +3 added lines, -3 removed lines

@@ -76,7 +76,7 @@ 
 	/**
 	 * Override to write to a different stream type.
 	 * @param string $string
-	 * @return bool
+	 * @return boolean|null
 	 */
 	function write( $string ) {
 		print $string;
@@ -87,7 +87,7 @@ 
 	 * and reopen new file with the old name. Use this
 	 * for writing out a file in multiple pieces
 	 * at specified checkpoints (e.g. every n hours).
-	 * @param string|array $newname File name. May be a string or an array with one element
+	 * @param string $newname File name. May be a string or an array with one element
 	 */
 	function closeRenameAndReopen( $newname ) {
 	}
@@ -96,7 +96,7 @@ 
 	 * Close the old file, and move it to a specified name.
 	 * Use this for the last piece of a file written out
 	 * at specified checkpoints (e.g. every n hours).
-	 * @param string|array $newname File name. May be a string or an array with one element
+	 * @param string $newname File name. May be a string or an array with one element
 	 * @param bool $open If true, a new file with the old filename will be opened
 	 *   again for writing (default: false)
 	 */