wikimedia / mediawiki

includes/skins/Skin.php

Doc Comments +2 added lines, -2 removed lines

@@ -1006,7 +1006,7 @@ 
 	}
 
 	/**
-	 * @param User|int $id
+	 * @param User $id
 	 * @return bool
 	 */
 	function showEmailUser( $id ) {
@@ -1469,7 +1469,7 @@ 
 	 * Get a cached notice
 	 *
 	 * @param string $name Message name, or 'default' for $wgSiteNotice
-	 * @return string|bool HTML fragment, or false to indicate that the caller
+	 * @return false|string HTML fragment, or false to indicate that the caller
 	 *   should fall back to the next notice in its sequence
 	 */
 	private function getCachedNotice( $name ) {

includes/specialpage/ChangesListSpecialPage.php

Doc Comments +2 added lines, -2 removed lines

@@ -107,7 +107,7 @@ 
 	/**
 	 * Create a FormOptions object with options as specified by the user
 	 *
-	 * @param array $parameters
+	 * @param string $parameters
 	 *
 	 * @return FormOptions
 	 */
@@ -368,7 +368,7 @@ 
 	/**
 	 * Build and output the actual changes list.
 	 *
-	 * @param array $rows Database rows
+	 * @param ResultWrapper $rows Database rows
 	 * @param FormOptions $opts
 	 */
 	abstract public function outputChangesList( $rows, $opts );

includes/specialpage/FormSpecialPage.php

Doc Comments +1 added lines, -2 removed lines

@@ -86,7 +86,7 @@ 
 
 	/**
 	 * Get the HTMLForm to control behavior
-	 * @return HTMLForm|null
+	 * @return HTMLForm
 	 */
 	protected function getForm() {
 		$form = HTMLForm::factory(
@@ -125,7 +125,6 @@ 
 	/**
 	 * Process the form on POST submission.
 	 * @param array $data
-	 * @param HTMLForm $form
 	 * @return bool|string|array|Status As documented for HTMLForm::trySubmit.
 	 */
 	abstract public function onSubmit( array $data /* $form = null */ );

includes/specialpage/IncludableSpecialPage.php

Doc Comments +4 added lines

@@ -27,6 +27,10 @@
  * @ingroup SpecialPage
  */
 class IncludableSpecialPage extends SpecialPage {
+
+	/**
+	 * @param string $name
+	 */
 	function __construct(
 		$name, $restriction = '', $listed = true, $function = false, $file = 'default'
 	) {

includes/specialpage/QueryPage.php

Doc Comments +5 added lines, -2 removed lines

@@ -161,7 +161,7 @@ 
 	 * Subclasses return an array of fields to order by here. Don't append
 	 * DESC to the field names, that'll be done automatically if
 	 * sortDescending() returns true.
-	 * @return array
+	 * @return string[]
 	 * @since 1.18
 	 */
 	function getOrderFields() {
@@ -435,7 +435,7 @@ 
 	/**
 	 * Somewhat deprecated, you probably want to be using execute()
 	 * @param int|bool $offset
-	 * @param int|bool $limit
+	 * @param integer $limit
 	 * @return ResultWrapper
 	 */
 	public function doQuery( $offset = false, $limit = false ) {
@@ -788,6 +788,9 @@ 
 		return isset( $row->comment ) ? htmlspecialchars( $row->comment ) : '';
 	}
 
+	/**
+	 * @return string
+	 */
 	function feedItemAuthor( $row ) {
 		return isset( $row->user_text ) ? $row->user_text : '';
 	}

includes/specialpage/RedirectSpecialPage.php

Doc Comments +9 added lines, -1 removed lines

@@ -118,6 +118,10 @@ 
 	/** @var string Name of subpage of redirect target */
 	protected $redirSubpage;
 
+	/**
+	 * @param string $name
+	 * @param string $redirName
+	 */
 	function __construct(
 		$name, $redirName, $redirSubpage = false,
 		$allowedRedirectParams = array(), $addedRedirectParams = array()
@@ -131,7 +135,7 @@ 
 
 	/**
 	 * @param string|null $subpage
-	 * @return Title|bool
+	 * @return Title
 	 */
 	public function getRedirect( $subpage ) {
 		if ( $this->redirSubpage === false ) {
@@ -206,6 +210,10 @@ 
  * @ingroup SpecialPage
  */
 abstract class RedirectSpecialArticle extends RedirectSpecialPage {
+
+	/**
+	 * @param string $name
+	 */
 	function __construct( $name ) {
 		parent::__construct( $name );
 		$redirectParams = array(

includes/specialpage/SpecialPage.php

Doc Comments +1 added lines, -1 removed lines

@@ -100,7 +100,7 @@
 	 * @param string $name Name of the special page, as seen in links and URLs
 	 * @param string $restriction User right required, e.g. "block" or "delete"
 	 * @param bool $listed Whether the page is listed in Special:Specialpages
-	 * @param callable|bool $function Unused
+	 * @param boolean $function Unused
 	 * @param string $file Unused
 	 * @param bool $includable Whether the page can be included in normal pages
 	 */

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' );