wikimedia / mediawiki

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/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 ) {

includes/media/SVGMetadataExtractor.php

Doc Comments +5 added lines, -1 removed lines

@@ -29,6 +29,10 @@ 
  * @ingroup Media
  */
 class SVGMetadataExtractor {
+
+	/**
+	 * @param string $filename
+	 */
 	static function getMetadata( $filename ) {
 		$svg = new SVGReader( $filename );
 
@@ -372,7 +376,7 @@ 
 	 * http://www.w3.org/TR/SVG11/coords.html#UnitIdentifiers
 	 *
 	 * @param string $length CSS/SVG length.
-	 * @param float|int $viewportSize Optional scale for percentage units...
+	 * @param integer $viewportSize Optional scale for percentage units...
 	 * @return float Length in pixels
 	 */
 	static function scaleSVGUnit( $length, $viewportSize = 512 ) {

includes/media/WebP.php

Doc Comments +4 added lines, -2 removed lines

@@ -43,6 +43,9 @@ 
 	const VP8X_XMP = 4;
 	const VP8X_ANIM = 2;
 
+	/**
+	 * @param string $filename
+	 */
 	public function getMetadata( $image, $filename ) {
 		$parsedWebPData = self::extractMetadata( $filename );
 		if ( !$parsedWebPData ) {
@@ -86,7 +89,6 @@ 
 	/**
 	 * Extracts the image size and WebP type from a file
 	 *
-	 * @param string $chunks Chunks as extracted by RiffExtractor
 	 * @return array|bool Header data array with entries 'compression', 'width' and 'height',
 	 * where 'compression' can be 'lossy', 'lossless', 'animated' or 'unknown'. False if
 	 * file is not a valid WebP file.
@@ -289,7 +291,7 @@ 
 	 * @param $ext
 	 * @param $mime
 	 * @param $params
-	 * @return array
+	 * @return string[]
 	 */
 	public function getThumbType( $ext, $mime, $params = null ) {
 		return array( 'png', 'image/png' );

includes/MovePage.php

Doc Comments +3 added lines

@@ -42,6 +42,9 @@
 		$this->newTitle = $newTitle;
 	}
 
+	/**
+	 * @param string $reason
+	 */
 	public function checkPermissions( User $user, $reason ) {
 		$status = new Status();
 

includes/page/WikiFilePage.php

Doc Comments +6 added lines, -3 removed lines

@@ -34,6 +34,9 @@ 
 	protected $mFileLoaded = false;		    // !<
 	protected $mDupes = null;				// !<
 
+	/**
+	 * @param Title $title
+	 */
 	public function __construct( $title ) {
 		parent::__construct( $title );
 		$this->mDupes = null;
@@ -66,7 +69,7 @@ 
 	}
 
 	/**
-	 * @return mixed|null|Title
+	 * @return Title|null
 	 */
 	public function getRedirectTarget() {
 		$this->loadFile();
@@ -120,7 +123,7 @@ 
 	}
 
 	/**
-	 * @return bool|File
+	 * @return File
 	 */
 	public function getFile() {
 		$this->loadFile();
@@ -192,7 +195,7 @@ 
 	 * For foreign API files (InstantCommons), this is not supported currently.
 	 * Results will include hidden categories.
 	 *
-	 * @return TitleArray|Title[]
+	 * @return TitleArrayFromResult|null
 	 * @since 1.23
 	 */
 	public function getForeignCategories() {