wikimedia / mediawiki

includes/specials/SpecialBlock.php

Doc Comments +2 added lines, -2 removed lines

@@ -230,7 +230,7 @@ 
 	 * If the user has already been blocked with similar settings, load that block
 	 * and change the defaults for the form fields to match the existing settings.
 	 * @param array $fields HTMLForm descriptor array
-	 * @return bool Whether fields were altered (that is, whether the target is
+	 * @return boolean|null Whether fields were altered (that is, whether the target is
 	 *     already blocked)
 	 */
 	protected function maybeAlterFormDefaults( &$fields ) {
@@ -453,7 +453,7 @@ 
 	/**
 	 * Get a user page target for things like logs.
 	 * This handles account and IP range targets.
-	 * @param User|string $target
+	 * @param User $target
 	 * @return Title|null
 	 */
 	protected static function getTargetUserTitle( $target ) {

includes/specials/SpecialBrokenRedirects.php

Doc Comments +1 added lines, -1 removed lines

@@ -85,7 +85,7 @@
 	}
 
 	/**
-	 * @return array
+	 * @return string[]
 	 */
 	function getOrderFields() {
 		return array( 'rd_namespace', 'rd_title', 'rd_from' );

includes/specials/SpecialComparePages.php

Doc Comments +3 added lines

@@ -128,6 +128,9 @@
 		}
 	}
 
+	/**
+	 * @return integer
+	 */
 	public static function revOrTitle( $revision, $title ) {
 		if ( $revision ) {
 			return $revision;

includes/specials/SpecialContributions.php

Doc Comments +2 added lines, -2 removed lines

@@ -238,7 +238,7 @@ 
 	/**
 	 * Generates the subheading with links
 	 * @param User $userObj User object for the target
-	 * @return string Appropriately-escaped HTML to be output literally
+	 * @return Message Appropriately-escaped HTML to be output literally
 	 * @todo FIXME: Almost the same as getSubTitle in SpecialDeletedContributions.php.
 	 * Could be combined.
 	 */
@@ -308,7 +308,7 @@ 
 	 * @param Title $userpage Target user page
 	 * @param Title $talkpage Talk page
 	 * @param User $target Target user object
-	 * @return array
+	 * @return string[]
 	 */
 	public function getUserLinks( Title $userpage, Title $talkpage, User $target ) {
 

includes/specials/SpecialEditTags.php

Doc Comments +1 added lines, -1 removed lines

@@ -348,7 +348,7 @@
 	 * ChangeTags::listExplicitlyDefinedTags, will be appended to the <select>
 	 * element.
 	 * @param string $label The text of a <label> to precede the <select>
-	 * @return array HTML <label> element at index 0, HTML <select> element at
+	 * @return string[] HTML <label> element at index 0, HTML <select> element at
 	 * index 1
 	 */
 	protected function getTagSelect( $selectedTags, $label ) {

includes/specials/SpecialExport.php

Doc Comments +1 added lines, -1 removed lines

@@ -544,7 +544,7 @@
 	 * @param array $pageSet
 	 * @param string $table
 	 * @param array $fields Array of field names
-	 * @param array $join
+	 * @param string[] $join
 	 * @return array
 	 */
 	private function getLinks( $inputPages, $pageSet, $table, $fields, $join ) {

includes/specials/SpecialFileDuplicateSearch.php

Doc Comments +5 added lines, -2 removed lines

@@ -59,7 +59,7 @@ 
 	/**
 	 * Fetch dupes from all connected file repositories.
 	 *
-	 * @return array Array of File objects
+	 * @return File[] Array of File objects
 	 */
 	function getDupes() {
 		return RepoGroup::singleton()->findBySha1( $this->hash );
@@ -67,7 +67,7 @@ 
 
 	/**
 	 *
-	 * @param array $dupes Array of File objects
+	 * @param File[] $dupes Array of File objects
 	 */
 	function showList( $dupes ) {
 		$html = array();
@@ -184,6 +184,9 @@ 
 		}
 	}
 
+	/**
+	 * @param File[] $list
+	 */
 	function doBatchLookups( $list ) {
 		$batch = new LinkBatch();
 		/** @var File $file */

includes/specials/SpecialFilepath.php

Doc Comments -1 removed lines

@@ -35,7 +35,6 @@
 	/**
 	 * Implement by redirecting through Special:Redirect/file.
 	 *
-	 * @param string|null $subpage
 	 * @return Title
 	 */
 	public function getRedirect( $par ) {

includes/specials/SpecialImport.php

Doc Comments +3 added lines

@@ -233,6 +233,9 @@
 		}
 	}
 
+	/**
+	 * @param string $sourceName
+	 */
 	private function getMappingFormPart( $sourceName ) {
 		$isSameSourceAsBefore = ( $this->sourceName === $sourceName );
 		$defaultNamespace = $this->getConfig()->get( 'ImportTargetNamespace' );