wikimedia / mediawiki

includes/widget/DateTimeInputWidget.php

Doc Comments -4 removed lines

@@ -21,10 +21,6 @@
 
 	/**
 	 * @param array $config Configuration options
-	 * @param string $config['type'] 'date', 'time', or 'datetime'
-	 * @param string $config['min'] Minimum date, time, or datetime
-	 * @param string $config['max'] Maximum date, time, or datetime
-	 * @param bool $config['clearable'] Whether to provide for blanking the value.
 	 */
 	public function __construct( array $config = [] ) {
 		// We need $this->type set before calling the parent constructor

includes/specialpage/AuthManagerSpecialPage.php

Doc Comments +2 added lines, -2 removed lines

@@ -196,7 +196,7 @@ 
 	 * Get the default action for this special page, if none is given via URL/POST data.
 	 * Subclasses should override this (or override loadAuth() so this is never called).
 	 * @param string $subPage Subpage of the special page.
-	 * @return string an AuthManager::ACTION_* constant.
+	 * @return string|null an AuthManager::ACTION_* constant.
 	 */
 	protected function getDefaultAction( $subPage ) {
 		throw new BadMethodCallException( 'Subclass did not implement getDefaultAction' );
@@ -732,7 +732,7 @@ 
 	 * Get an array value, or a default if it does not exist.
 	 * @param array $array
 	 * @param string $fieldName
-	 * @param mixed $default
+	 * @param integer $default
 	 * @return mixed
 	 */
 	protected static function getField( array $array, $fieldName, $default = null ) {

includes/db/DatabaseOracle.php

Doc Comments +28 added lines

@@ -85,6 +85,9 @@ 
 		unset( $this->db );
 	}
 
+	/**
+	 * @param integer $row
+	 */
 	public function seek( $row ) {
 		$this->cursor = min( $row, $this->nrows );
 	}
@@ -440,6 +443,9 @@ 
 		}
 	}
 
+	/**
+	 * @return string
+	 */
 	function lastError() {
 		if ( $this->mConn === false ) {
 			$e = oci_error();
@@ -480,6 +486,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $table
+	 */
 	function insert( $table, $a, $fname = __METHOD__, $options = [] ) {
 		if ( !count( $a ) ) {
 			return true;
@@ -509,6 +518,9 @@ 
 		return $retVal;
 	}
 
+	/**
+	 * @param string $table
+	 */
 	private function fieldBindStatement( $table, $col, &$val, $includeCol = false ) {
 		$col_info = $this->fieldInfoMulti( $table, $col );
 		$col_type = $col_info != false ? $col_info->type() : 'CONSTANT';
@@ -751,6 +763,9 @@ 
 		return strtoupper( parent::tableName( $name, $format ) );
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function tableNameInternal( $name ) {
 		$name = $this->tableName( $name );
 
@@ -1173,6 +1188,9 @@ 
 		return true;
 	}
 
+	/**
+	 * @param string $db
+	 */
 	function selectDB( $db ) {
 		$this->mDBname = $db;
 		if ( $db == null || $db == $this->mUser ) {
@@ -1208,6 +1226,9 @@ 
 		return "'" . $this->strencode( $s ) . "'";
 	}
 
+	/**
+	 * @param string $s
+	 */
 	public function addIdentifierQuotes( $s ) {
 		if ( !$this->getFlag( DBO_DDLMODE ) ) {
 			$s = '/*Q*/' . $s;
@@ -1311,6 +1332,10 @@ 
 		return [ $startOpts, $useIndex, $preLimitTail, $postLimitTail, $ignoreIndex ];
 	}
 
+	/**
+	 * @param string $table
+	 * @param string $conds
+	 */
 	public function delete( $table, $conds, $fname = __METHOD__ ) {
 		if ( is_array( $conds ) ) {
 			$conds = $this->wrapConditionsForWhere( $table, $conds );
@@ -1472,6 +1497,9 @@ 
 		return 'BITOR(' . $fieldLeft . ', ' . $fieldRight . ')';
 	}
 
+	/**
+	 * @return string
+	 */
 	function getDBname() {
 		return $this->mDBname;
 	}

includes/pager/IndexPager.php

Doc Comments +1 added lines, -1 removed lines

@@ -182,7 +182,7 @@
 	/**
 	 * Get the Database object in use
 	 *
-	 * @return IDatabase
+	 * @return Database|null
 	 */
 	public function getDatabase() {
 		return $this->mDb;

includes/PrefixSearch.php

Doc Comments +5 added lines

@@ -186,6 +186,11 @@
 			$this->handleResultFromHook( $srchres, $namespaces, $search, $limit, $offset ) );
 	}
 
+	/**
+	 * @param string $search
+	 * @param integer $limit
+	 * @param integer $offset
+	 */
 	private function handleResultFromHook( $srchres, $namespaces, $search, $limit, $offset ) {
 		if ( $offset === 0 ) {
 			// Only perform exact db match if offset === 0

includes/resourceloader/ResourceLoaderWikiModule.php

Doc Comments +3 added lines, -3 removed lines

@@ -136,14 +136,14 @@ 
 	 * NOTE: This ONLY works for getTitleInfo() and isKnownEmpty(), NOT FOR ANYTHING ELSE.
 	 * In particular, it doesn't work for getContent() or getScript() etc.
 	 *
-	 * @return IDatabase|null
+	 * @return Database|null
 	 */
 	protected function getDB() {
 		return wfGetDB( DB_REPLICA );
 	}
 
 	/**
-	 * @param string $title
+	 * @param string $titleText
 	 * @return null|string
 	 */
 	protected function getContent( $titleText ) {
@@ -336,7 +336,7 @@ 
 	 * @since 1.28
 	 * @param ResourceLoaderContext $context
 	 * @param IDatabase $db
-	 * @param string[] $modules
+	 * @param string[] $moduleNames
 	 */
 	public static function preloadTitleInfo(
 		ResourceLoaderContext $context, IDatabase $db, array $moduleNames

includes/SiteStats.php

Doc Comments +1 added lines, -1 removed lines

@@ -371,7 +371,7 @@
 	 * Do all updates and commit them. More or less a replacement
 	 * for the original initStats, but without output.
 	 *
-	 * @param IDatabase|bool $database
+	 * @param Database|null $database
 	 * - boolean: Whether to use the master DB
 	 * - IDatabase: Database connection to use
 	 * @param array $options Array of options, may contain the following values

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
 	 */
@@ -337,7 +337,7 @@ 
 	/**
 	 * Return a IDatabase object for reading
 	 *
-	 * @return IDatabase
+	 * @return Database|null
 	 */
 	protected function getDB() {
 		return wfGetDB( DB_REPLICA );

includes/specialpage/QueryPage.php

Doc Comments +7 added lines, -4 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() {
@@ -373,7 +373,7 @@ 
 
 	/**
 	 * Get a DB connection to be used for slow recache queries
-	 * @return IDatabase
+	 * @return Database|null
 	 */
 	function getRecacheDB() {
 		return wfGetDB( DB_REPLICA, [ $this->getName(), 'QueryPage::recache', 'vslow' ] );
@@ -434,7 +434,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 ) {
@@ -775,7 +775,7 @@ 
 	/**
 	 * Override for custom handling. If the titles/links are ok, just do
 	 * feedItemDesc()
-	 * @param object $row
+	 * @param null|stdClass $row
 	 * @return FeedItem|null
 	 */
 	function feedResult( $row ) {
@@ -807,6 +807,9 @@ 
 		return isset( $row->comment ) ? htmlspecialchars( $row->comment ) : '';
 	}
 
+	/**
+	 * @return string
+	 */
 	function feedItemAuthor( $row ) {
 		return isset( $row->user_text ) ? $row->user_text : '';
 	}