wikimedia / mediawiki

includes/revisiondelete/RevDelRevisionItem.php

Doc Comments +3 added lines

@@ -26,6 +26,9 @@
 	/** @var Revision */
 	public $revision;
 
+	/**
+	 * @param RevDelRevisionList $list
+	 */
 	public function __construct( $list, $row ) {
 		parent::__construct( $list, $row );
 		$this->revision = new Revision( $row );

includes/RevisionList.php

Doc Comments +2 added lines, -2 removed lines

@@ -57,7 +57,7 @@ 
 	/**
 	 * Get the internal type name of this list. Equal to the table name.
 	 * Override this function.
-	 * @return null
+	 * @return string
 	 */
 	public function getType() {
 		return null;
@@ -216,7 +216,7 @@ 
 
 	/**
 	 * Get the timestamp in MW 14-char form
-	 * @return mixed
+	 * @return string|false
 	 */
 	public function getTimestamp() {
 		$field = $this->getTimestampField();

includes/Sanitizer.php

Doc Comments +5 added lines, -5 removed lines

@@ -448,7 +448,7 @@ 
 	 *   replacements in HTML attribute values
 	 * @param array|bool $args Arguments for the processing callback
 	 * @param array $extratags For any extra tags to include
-	 * @param array $removetags For any tags (default or extra) to exclude
+	 * @param string[] $removetags For any tags (default or extra) to exclude
 	 * @return string
 	 */
 	public static function removeHTMLtags( $text, $processCallback = null,
@@ -1212,7 +1212,7 @@ 
 	 * character references are decoded to UTF-8 text.
 	 *
 	 * @param string $text
-	 * @return array
+	 * @return callable
 	 */
 	public static function decodeTagAttributes( $text ) {
 		if ( trim( $text ) == '' ) {
@@ -1265,7 +1265,7 @@ 
 	 * Pick the appropriate attribute value from a match set from the
 	 * attribs regex matches.
 	 *
-	 * @param array $set
+	 * @param string[] $set
 	 * @throws MWException When tag conditions are not met.
 	 * @return string
 	 */
@@ -1780,7 +1780,7 @@ 
 
 	/**
 	 * @param string $url
-	 * @return mixed|string
+	 * @return string
 	 */
 	static function cleanUrl( $url ) {
 		# Normalize any HTML entities in input. They will be
@@ -1866,7 +1866,7 @@ 
 	 * @since 1.18
 	 *
 	 * @param string $addr E-mail address
-	 * @return bool
+	 * @return null|boolean
 	 */
 	public static function validateEmail( $addr ) {
 		$result = null;

includes/search/SearchEngine.php

Doc Comments +3 added lines, -3 removed lines

@@ -95,8 +95,8 @@ 
 	 * Way to pass custom data for engines
 	 * @since 1.18
 	 * @param string $feature
-	 * @param mixed $data
-	 * @return bool
+	 * @param boolean $data
+	 * @return boolean|null
 	 */
 	public function setFeatureData( $feature, $data ) {
 		$this->features[$feature] = $data;
@@ -419,7 +419,7 @@ 
 	/**
 	 * Find snippet highlight settings for all users
 	 *
-	 * @return array Contextlines, contextchars
+	 * @return integer[] Contextlines, contextchars
 	 */
 	public static function userHighlightPrefs() {
 		$contextlines = 2; // Hardcode this. Old defaults sucked. :)

includes/search/SearchExactMatchRescorer.php

Doc Comments +1 added lines

@@ -120,6 +120,7 @@
 	 * Returns an array where the element of $array at index $key becomes
 	 * the first element.
 	 * @param int $key key to pull to the front
+	 * @param string[] $array
 	 * @return array $array with the item at $key pulled to the front
 	 */
 	private function pullFront( $key, $array ) {

includes/search/SearchHighlighter.php

Doc Comments +1 added lines, -1 removed lines

@@ -440,7 +440,7 @@
 	 * Basic wikitext removal
 	 * @protected
 	 * @param string $text
-	 * @return mixed
+	 * @return string
 	 */
 	function removeWiki( $text ) {
 		$text = preg_replace( "/\\{\\{([^|]+?)\\}\\}/", "", $text );

includes/search/SearchMySQL.php

Doc Comments +5 added lines, -1 removed lines

@@ -173,6 +173,10 @@ 
 		return $this->searchInternal( $term, false );
 	}
 
+	/**
+	 * @param string $term
+	 * @param boolean $fulltext
+	 */
 	protected function searchInternal( $term, $fulltext ) {
 		// This seems out of place, why is this called with empty term?
 		if ( trim( $term ) === '' ) {
@@ -377,7 +381,7 @@ 
 	 * Converts some characters for MySQL's indexing to grok it correctly,
 	 * and pads short words to overcome limitations.
 	 * @param string $string
-	 * @return mixed|string
+	 * @return string
 	 */
 	function normalizeText( $string ) {
 		global $wgContLang;

includes/search/SearchResult.php

Doc Comments +1 added lines, -1 removed lines

@@ -107,7 +107,7 @@
 
 	/**
 	 * Get the file for this page, if one exists
-	 * @return File|null
+	 * @return File
 	 */
 	function getFile() {
 		return $this->mImage;

includes/search/SearchResultSet.php

Doc Comments +1 added lines, -1 removed lines

@@ -148,7 +148,7 @@
 	 * Fetches next search result, or false.
 	 * STUB
 	 *
-	 * @return SearchResult
+	 * @return boolean
 	 */
 	function next() {
 		return false;