wikimedia / mediawiki

includes/widget/SearchInputWidget.php

Doc Comments -7 removed lines

@@ -20,13 +20,6 @@
 
 	/**
 	 * @param array $config Configuration options
-	 * @param int|null $config['pushPending'] Whether the input should be visually marked as
-	 *  "pending", while requesting suggestions (default: true)
-	 * @param boolean|null $config['performSearchOnClick'] If true, the script will start a search
-	 *  whenever a user hits a suggestion. If false, the text of the suggestion is inserted into the
-	 *  text field only (default: true)
-	 * @param string $config['dataLocation'] Where the search input field will be
-	 *  used (header or content, default: header)
 	 */
 	public function __construct( array $config = [] ) {
 		$config = array_merge( [

includes/api/ApiBase.php

Doc Comments +13 added lines, -9 removed lines

@@ -408,7 +408,7 @@ 
 	 * Returning true will generate errors indicating that the API module needs
 	 * updating.
 	 *
-	 * @return string|false
+	 * @return boolean
 	 */
 	public function needsToken() {
 		return false;
@@ -421,7 +421,7 @@ 
 	 *
 	 * @since 1.24
 	 * @param array $params All supplied parameters for the module
-	 * @return string|array|null
+	 * @return string
 	 */
 	protected function getWebUITokenSalt( array $params ) {
 		return null;
@@ -486,7 +486,7 @@ 
 	/**
 	 * Get the parent of this module
 	 * @since 1.25
-	 * @return ApiBase|null
+	 * @return ApiMain
 	 */
 	public function getParent() {
 		return $this->isMain() ? null : $this->getMain();
@@ -621,6 +621,7 @@ 
 	/**
 	 * Set the continuation manager
 	 * @param ApiContinuationManager|null
+	 * @param ApiContinuationManager|null $manager
 	 */
 	public function setContinuationManager( $manager ) {
 		// Main module has setContinuationManager() method overridden
@@ -704,6 +705,7 @@ 
 	 *
 	 * @param array $params User provided set of parameters, as from $this->extractRequestParams()
 	 * @param string $required,... Names of parameters of which exactly one must be set
+	 * @param string $required
 	 */
 	public function requireOnlyOneParameter( $params, $required /*...*/ ) {
 		$required = func_get_args();
@@ -730,6 +732,7 @@ 
 	 *
 	 * @param array $params User provided set of parameters, as from $this->extractRequestParams()
 	 * @param string $required,... Names of parameters of which at most one must be set
+	 * @param string $required
 	 */
 	public function requireMaxOneParameter( $params, $required /*...*/ ) {
 		$required = func_get_args();
@@ -753,6 +756,7 @@ 
 	 * @since 1.23
 	 * @param array $params User provided set of parameters, as from $this->extractRequestParams()
 	 * @param string $required,... Names of parameters of which at least one must be set
+	 * @param string $required
 	 */
 	public function requireAtLeastOneParameter( $params, $required /*...*/ ) {
 		$required = func_get_args();
@@ -2531,7 +2535,7 @@ 
 	 * "apihelp-{$this->getModulePath()}-description".
 	 *
 	 * @deprecated since 1.25
-	 * @return Message|string|array
+	 * @return boolean
 	 */
 	protected function getDescription() {
 		return false;
@@ -2567,7 +2571,7 @@ 
 	 * that value, and boolean false means "no examples".
 	 *
 	 * @deprecated since 1.25, use getExamplesMessages() instead
-	 * @return bool|string|array
+	 * @return boolean
 	 */
 	protected function getExamples() {
 		return false;
@@ -2576,7 +2580,7 @@ 
 	/**
 	 * Generates help message for this module, or false if there is no description
 	 * @deprecated since 1.25
-	 * @return string|bool
+	 * @return string
 	 */
 	public function makeHelpMsg() {
 		wfDeprecated( __METHOD__, '1.25' );
@@ -2686,7 +2690,7 @@ 
 	 * Generates the parameter descriptions for this module, to be displayed in the
 	 * module's help.
 	 * @deprecated since 1.25
-	 * @return string|bool
+	 * @return string|false
 	 */
 	public function makeHelpMsgParameters() {
 		wfDeprecated( __METHOD__, '1.25' );
@@ -2877,7 +2881,7 @@ 
 
 	/**
 	 * @deprecated since 1.25, always returns 0
-	 * @return float
+	 * @return integer
 	 */
 	public function getProfileTime() {
 		wfDeprecated( __METHOD__, '1.25' );
@@ -2900,7 +2904,7 @@ 
 
 	/**
 	 * @deprecated since 1.25, always returns 0
-	 * @return float
+	 * @return integer
 	 */
 	public function getProfileDBTime() {
 		wfDeprecated( __METHOD__, '1.25' );

includes/parser/BlockLevelPass.php

Doc Comments +2 added lines

@@ -53,6 +53,8 @@
 
 	/**
 	 * Private constructor
+	 * @param string $text
+	 * @param boolean $lineStart
 	 */
 	private function __construct( $text, $lineStart ) {
 		$this->text = $text;

maintenance/backup.inc

Doc Comments +5 added lines, -1 removed lines

@@ -334,7 +334,7 @@ 
 	 * Force the dump to use the provided database connection for database
 	 * operations, wherever possible.
 	 *
-	 * @param DatabaseBase|null $db (Optional) the database connection to use. If null, resort to
+	 * @param null|IDatabase $db (Optional) the database connection to use. If null, resort to
 	 *   use the globally provided ways to get database connections.
 	 */
 	function setDB( IDatabase $db = null ) {
@@ -422,6 +422,10 @@ 
 }
 
 class ExportProgressFilter extends DumpFilter {
+
+	/**
+	 * @param BackupDumper $progress
+	 */
 	function __construct( &$sink, &$progress ) {
 		parent::__construct( $sink );
 		$this->progress = $progress;

maintenance/backupPrefetch.inc

Doc Comments +3 added lines

@@ -47,6 +47,9 @@
 	protected $lastRev = 0;
 	protected $infiles = null;
 
+	/**
+	 * @param string $infile
+	 */
 	public function __construct( $infile ) {
 		$this->infiles = explode( ';', $infile );
 		$this->reader = new XMLReader();

maintenance/cleanupImages.php

Doc Comments +6 added lines

@@ -117,10 +117,16 @@
 		return $this->repo->getRootDirectory() . '/' . $this->repo->getHashPath( $name ) . $name;
 	}
 
+	/**
+	 * @param IDatabase $db
+	 */
 	private function imageExists( $name, $db ) {
 		return $db->selectField( 'image', '1', [ 'img_name' => $name ], __METHOD__ );
 	}
 
+	/**
+	 * @param IDatabase $db
+	 */
 	private function pageExists( $name, $db ) {
 		return $db->selectField(
 			'page',

maintenance/cleanupTable.inc

Doc Comments +3 added lines

@@ -60,6 +60,9 @@
 		$this->runTable( $this->defaultParams );
 	}
 
+	/**
+	 * @param integer $count
+	 */
 	protected function init( $count, $table ) {
 		$this->processed = 0;
 		$this->updated = 0;

maintenance/language/checkLanguage.inc

Doc Comments +5 added lines, -5 removed lines

@@ -94,7 +94,7 @@ 
 
 	/**
 	 * Get the default checks.
-	 * @return array A list of the default checks.
+	 * @return string[] A list of the default checks.
 	 */
 	protected function defaultChecks() {
 		return [
@@ -107,7 +107,7 @@ 
 
 	/**
 	 * Get the checks which check other things than messages.
-	 * @return array A list of the non-message checks.
+	 * @return string[] A list of the non-message checks.
 	 */
 	protected function nonMessageChecks() {
 		return [
@@ -118,7 +118,7 @@ 
 
 	/**
 	 * Get the checks that can easily be treated by non-speakers of the language.
-	 * @return array A list of the easy checks.
+	 * @return string[] A list of the easy checks.
 	 */
 	protected function easyChecks() {
 		return [
@@ -643,7 +643,7 @@ 
 
 	/**
 	 * Get the default checks.
-	 * @return array A list of the default checks.
+	 * @return string[] A list of the default checks.
 	 */
 	protected function defaultChecks() {
 		return [
@@ -662,7 +662,7 @@ 
 
 	/**
 	 * Get the checks that can easily be treated by non-speakers of the language.
-	 * @return array A list of the easy checks.
+	 * @return string[] A list of the easy checks.
 	 */
 	protected function easyChecks() {
 		return [

maintenance/userDupes.inc

Doc Comments +3 added lines

@@ -39,6 +39,9 @@
 	private $failed;
 	private $outputCallback;
 
+	/**
+	 * @param DatabaseBase $database
+	 */
 	function __construct( &$database, $outputCallback ) {
 		$this->db = $database;
 		$this->outputCallback = $outputCallback;