wikimedia / mediawiki

includes/libs/replacers/DoubleReplacer.php

Doc Comments +2 added lines, -2 removed lines

@@ -23,8 +23,8 @@
  */
 class DoubleReplacer extends Replacer {
 	/**
-	 * @param mixed $from
-	 * @param mixed $to
+	 * @param string $from
+	 * @param string $to
 	 * @param int $index
 	 */
 	public function __construct( $from, $to, $index = 0 ) {

includes/libs/SamplingStatsdClient.php

Doc Comments +1 added lines

@@ -35,6 +35,7 @@
 	 * The sample rate specified in a StatsdData entity overrides the sample rate specified here.
 	 *
 	 * {@inheritDoc}
+	 * @return StatsdDataInterface[]
 	 */
 	public function appendSampleRate( $data, $sampleRate = 1 ) {
 		if ( $sampleRate < 1 ) {

includes/libs/XmlTypeCheck.php

Doc Comments +6 added lines, -2 removed lines

@@ -134,7 +134,8 @@ 
 
 
 	/**
-	 * @param string $fname the filename
+	 * @param string $xml
+	 * @param boolean $isFile
 	 */
 	private function validateFromInput( $xml, $isFile ) {
 		$reader = new XMLReader();
@@ -175,6 +176,9 @@ 
 		$this->wellFormed = false;
 	}
 
+	/**
+	 * @param XMLReader $reader
+	 */
 	private function validate( $reader ) {
 
 		// First, move through anything that isn't an element, and
@@ -286,7 +290,7 @@ 
 	}
 
 	/**
-	 * @param $name
+	 * @param string $name
 	 * @param $attribs
 	 */
 	private function elementOpen( $name, $attribs ) {

includes/Licenses.php

Doc Comments +1 added lines, -1 removed lines

@@ -94,7 +94,7 @@
 	/**
 	 * @param array $list
 	 * @param array $path
-	 * @param mixed $item
+	 * @param License $item
 	 */
 	protected function stackItem( &$list, $path, $item ) {
 		$position =& $list;

includes/logging/LogEventsList.php

Doc Comments +3 added lines, -3 removed lines

@@ -413,8 +413,8 @@ 
 
 	/**
 	 * @param stdClass $row Row
-	 * @param string|array $type
-	 * @param string|array $action
+	 * @param string[] $type
+	 * @param string $action
 	 * @param string $right
 	 * @return bool
 	 */
@@ -649,7 +649,7 @@ 
 	 * @param IDatabase $db
 	 * @param string $audience Public/user
 	 * @param User $user User to check, or null to use $wgUser
-	 * @return string|bool String on success, false on failure.
+	 * @return string|false String on success, false on failure.
 	 */
 	public static function getExcludeClause( $db, $audience = 'public', User $user = null ) {
 		global $wgLogRestrictions;

includes/mail/EmailNotification.php

Doc Comments +1 added lines, -1 removed lines

@@ -474,7 +474,7 @@
 	 *
 	 * @param User $watchingUser
 	 * @param string $source
-	 * @return bool
+	 * @return Status
 	 * @private
 	 */
 	function sendPersonalised( $watchingUser, $source ) {

includes/media/DjVuImage.php

Doc Comments +12 added lines

@@ -94,6 +94,11 @@ 
 		fclose( $file );
 	}
 
+	/**
+	 * @param resource $file
+	 * @param string $length
+	 * @param integer $indent
+	 */
 	private function dumpForm( $file, $length, $indent ) {
 		$start = ftell( $file );
 		$secondary = fread( $file, 4 );
@@ -187,6 +192,10 @@ 
 		}
 	}
 
+	/**
+	 * @param resource $file
+	 * @param string $formLength
+	 */
 	private function getMultiPageInfo( $file, $formLength ) {
 		// For now, we'll just look for the first page in the file
 		// and report its information, hoping others are the same size.
@@ -390,6 +399,9 @@ 
 		return $xml;
 	}
 
+	/**
+	 * @param string $line
+	 */
 	function parseFormDjvu( $line, &$xml ) {
 		$parentLevel = strspn( $line, ' ' );
 		$line = strtok( "\n" );

includes/media/FormatMetadata.php

Doc Comments +3 added lines, -3 removed lines

@@ -1230,8 +1230,8 @@ 
 	 * numbers, joins arrays of numbers with commas.
 	 *
 	 * @param mixed $num The value to format
-	 * @param float|int|bool $round Digits to round to or false.
-	 * @return mixed A floating point number or whatever we were fed
+	 * @param integer $round Digits to round to or false.
+	 * @return string|null A floating point number or whatever we were fed
 	 */
 	private function formatNum( $num, $round = false ) {
 		$m = array();
@@ -1396,7 +1396,7 @@ 
 	 *
 	 * @param int $coord Degrees, minutes and seconds
 	 * @param string $type Latitude or longitude (for if its a NWS or E)
-	 * @return mixed A floating point number or whatever we were fed
+	 * @return string A floating point number or whatever we were fed
 	 */
 	private function formatCoords( $coord, $type ) {
 		$ref = '';

includes/media/JpegMetadataExtractor.php

Doc Comments +1 added lines, -1 removed lines

@@ -44,7 +44,7 @@
 	 * and those can't extract xmp on files containing both exif and xmp data
 	 *
 	 * @param string $filename Name of jpeg file
-	 * @return array Array of interesting segments.
+	 * @return string Array of interesting segments.
 	 * @throws MWException If given invalid file.
 	 */
 	static function segmentSplitter( $filename ) {