wikimedia / mediawiki

includes/Revision.php

Doc Comments +10 added lines, -10 removed lines

@@ -423,7 +423,7 @@ 
 	/**
 	 * Return the list of revision fields that should be selected to create
 	 * a new revision.
-	 * @return array
+	 * @return string[]
 	 */
 	public static function selectFields() {
 		global $wgContentHandlerUseDB;
@@ -454,7 +454,7 @@ 
 	/**
 	 * Return the list of revision fields that should be selected to create
 	 * a new revision from an archive row.
-	 * @return array
+	 * @return string[]
 	 */
 	public static function selectArchiveFields() {
 		global $wgContentHandlerUseDB;
@@ -485,7 +485,7 @@ 
 	/**
 	 * Return the list of text fields that should be selected to read the
 	 * revision text
-	 * @return array
+	 * @return string[]
 	 */
 	public static function selectTextFields() {
 		return array(
@@ -496,7 +496,7 @@ 
 
 	/**
 	 * Return the list of page fields that should be selected from page table
-	 * @return array
+	 * @return string[]
 	 */
 	public static function selectPageFields() {
 		return array(
@@ -511,7 +511,7 @@ 
 
 	/**
 	 * Return the list of user fields that should be selected from user table
-	 * @return array
+	 * @return string[]
 	 */
 	public static function selectUserFields() {
 		return array( 'user_name' );
@@ -756,7 +756,7 @@ 
 	/**
 	 * Returns the base36 sha1 of the text in this revision, or null if unknown.
 	 *
-	 * @return string|null
+	 * @return string
 	 */
 	public function getSha1() {
 		return $this->mSha1;
@@ -838,7 +838,7 @@ 
 	/**
 	 * Fetch revision's user id without regard for the current user's permissions
 	 *
-	 * @return string
+	 * @return integer
 	 * @deprecated since 1.25, use getUser( Revision::RAW )
 	 */
 	public function getRawUser() {
@@ -1533,7 +1533,7 @@ 
 	 * Lazy-load the revision's text.
 	 * Currently hardcoded to the 'text' table storage engine.
 	 *
-	 * @return string|bool The revision's text, or false on failure
+	 * @return string The revision's text, or false on failure
 	 */
 	protected function loadText() {
 		// Caching may be beneficial for massive use of external storage
@@ -1734,7 +1734,7 @@ 
 	 *
 	 * @param Title $title
 	 * @param int $id
-	 * @return string|bool False if not found
+	 * @return string|false False if not found
 	 */
 	static function getTimestampFromId( $title, $id, $flags = 0 ) {
 		$db = ( $flags & self::READ_LATEST )
@@ -1790,7 +1790,7 @@ 
 	 * @since 1.20
 	 * @deprecated since 1.24
 	 *
-	 * @param IDatabase|int $db The Database to perform the check on. May be given as a
+	 * @param integer $db The Database to perform the check on. May be given as a
 	 *        Database object or a database identifier usable with wfGetDB.
 	 * @param int $pageId The ID of the page in question
 	 * @param int $userId The ID of the user in question

includes/revisiondelete/RevDelArchivedFileItem.php

Doc Comments +4 added lines

@@ -23,6 +23,10 @@
  * Item class for a filearchive table row
  */
 class RevDelArchivedFileItem extends RevDelFileItem {
+
+	/**
+	 * @param RevDelArchivedFileList $list
+	 */
 	public function __construct( $list, $row ) {
 		RevDelItem::__construct( $list, $row );
 		$this->file = ArchivedFile::newFromRow( $row );

includes/revisiondelete/RevDelFileItem.php

Doc Comments +3 added lines

@@ -26,6 +26,9 @@
 	/** @var File */
 	public $file;
 
+	/**
+	 * @param RevDelFileList $list
+	 */
 	public function __construct( $list, $row ) {
 		parent::__construct( $list, $row );
 		$this->file = RepoGroup::singleton()->getLocalRepo()->newFileFromRow( $row );

includes/revisiondelete/RevDelLogList.php

Doc Comments +3 added lines

@@ -39,6 +39,9 @@
 		return LogPage::DELETED_ACTION;
 	}
 
+	/**
+	 * @param integer $target
+	 */
 	public static function suggestTarget( $target, array $ids ) {
 		$result = wfGetDB( DB_SLAVE )->select( 'logging',
 			'log_type',

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/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;