wikimedia / mediawiki

includes/Category.php

Doc Comments +8 added lines, -8 removed lines

@@ -126,7 +126,7 @@ 
 	 * Factory function.
 	 *
 	 * @param Title $title Title for the category page
-	 * @return Category|bool On a totally invalid name
+	 * @return Category On a totally invalid name
 	 */
 	public static function newFromTitle( $title ) {
 		$cat = new self();
@@ -196,42 +196,42 @@ 
 	}
 
 	/**
-	 * @return mixed DB key name, or false on failure
+	 * @return boolean DB key name, or false on failure
 	 */
 	public function getName() {
 		return $this->getX( 'mName' );
 	}
 
 	/**
-	 * @return mixed Category ID, or false on failure
+	 * @return boolean Category ID, or false on failure
 	 */
 	public function getID() {
 		return $this->getX( 'mID' );
 	}
 
 	/**
-	 * @return mixed Total number of member pages, or false on failure
+	 * @return boolean Total number of member pages, or false on failure
 	 */
 	public function getPageCount() {
 		return $this->getX( 'mPages' );
 	}
 
 	/**
-	 * @return mixed Number of subcategories, or false on failure
+	 * @return boolean Number of subcategories, or false on failure
 	 */
 	public function getSubcatCount() {
 		return $this->getX( 'mSubcats' );
 	}
 
 	/**
-	 * @return mixed Number of member files, or false on failure
+	 * @return boolean Number of member files, or false on failure
 	 */
 	public function getFileCount() {
 		return $this->getX( 'mFiles' );
 	}
 
 	/**
-	 * @return Title|bool Title for this category, or false on failure.
+	 * @return Title Title for this category, or false on failure.
 	 */
 	public function getTitle() {
 		if ( $this->mTitle ) {
@@ -251,7 +251,7 @@ 
 	 * category sort key $offset.
 	 * @param int $limit
 	 * @param string $offset
-	 * @return TitleArray TitleArray object for category members.
+	 * @return TitleArrayFromResult|null TitleArray object for category members.
 	 */
 	public function getMembers( $limit = false, $offset = '' ) {
 

includes/CategoryViewer.php

Doc Comments +4 added lines

@@ -188,6 +188,10 @@
 			$this->getSubcategorySortChar( $cat->getTitle(), $sortkey );
 	}
 
+	/**
+	 * @param string $type
+	 * @param string $html
+	 */
 	function generateLink( $type, Title $title, $isRedirect, $html = null ) {
 		$link = null;
 		Hooks::run( 'CategoryViewer::generateLink', array( $type, $title, $html, &$link ) );

includes/changes/CategoryMembershipChange.php

Doc Comments +1 added lines, -1 removed lines

@@ -207,7 +207,7 @@
 	 * False will be returned if the user name specified in the
 	 * 'autochange-username' message is invalid.
 	 *
-	 * @return User|bool
+	 * @return null|User
 	 */
 	private function getUser() {
 		if ( $this->revision ) {

includes/changes/EnhancedChangesList.php

Doc Comments +1 added lines, -1 removed lines

@@ -447,7 +447,7 @@
 	/**
 	 * Generates amount of changes (linking to diff ) & link to history.
 	 *
-	 * @param array $block
+	 * @param RCCacheEntry[] $block
 	 * @param array $queryParams
 	 * @param bool $allLogs
 	 * @param bool $isnew

includes/changes/OldChangesList.php

Doc Comments +1 added lines, -1 removed lines

@@ -29,7 +29,7 @@
 	 * @param bool $watched (default false)
 	 * @param int $linenumber (default null)
 	 *
-	 * @return string|bool
+	 * @return false|string
 	 */
 	public function recentChangesLine( &$rc, $watched = false, $linenumber = null ) {
 

includes/changes/RecentChange.php

Doc Comments +6 added lines, -3 removed lines

@@ -119,7 +119,7 @@ 
 	 * @since 1.24
 	 * @param string|array $type
 	 * @throws MWException
-	 * @return int|array RC_TYPE
+	 * @return string RC_TYPE
 	 */
 	public static function parseToRCType( $type ) {
 		if ( is_array( $type ) ) {
@@ -172,7 +172,7 @@ 
 	 * Find the first recent change matching some specific conditions
 	 *
 	 * @param array $conds Array of conditions
-	 * @param mixed $fname Override the method name in profiling/logs
+	 * @param string $fname Override the method name in profiling/logs
 	 * @param int $dbType DB_* constant
 	 *
 	 * @return RecentChange|null
@@ -194,7 +194,7 @@ 
 	/**
 	 * Return the list of recentchanges fields that should be selected to create
 	 * a new recentchanges object.
-	 * @return array
+	 * @return string[]
 	 */
 	public static function selectFields() {
 		return array(
@@ -919,6 +919,9 @@ 
 		return ChangesList::showCharacterDifference( $old, $new );
 	}
 
+	/**
+	 * @param string $ip
+	 */
 	private static function checkIPAddress( $ip ) {
 		global $wgRequest;
 		if ( $ip ) {

includes/changetags/ChangeTags.php

Doc Comments +4 added lines, -1 removed lines

@@ -89,7 +89,7 @@ 
 	 * we consider the tag hidden, and return false.
 	 *
 	 * @param string $tag Tag
-	 * @return string|bool Tag description or false if tag is to be hidden.
+	 * @return string|false Tag description or false if tag is to be hidden.
 	 * @since 1.25 Returns false if tag is to be hidden.
 	 */
 	public static function tagDescription( $tag ) {
@@ -145,6 +145,9 @@ 
 	 * Pass a variable whose value is null if the log_id is not relevant or unknown.
 	 * @param string $params Params to put in the ct_params field of table
 	 * 'change_tag' when adding tags
+	 * @param integer $rc_id
+	 * @param integer $rev_id
+	 * @param integer $log_id
 	 *
 	 * @throws MWException When $rc_id, $rev_id and $log_id are all null
 	 * @return array Index 0 is an array of tags actually added, index 1 is an

includes/context/DerivativeContext.php

Doc Comments -1 removed lines

@@ -329,7 +329,6 @@
 	 * it would set only the original context, and not take
 	 * into account any changes.
 	 *
-	 * @param mixed $args,... Arguments to wfMessage
 	 * @return Message
 	 */
 	public function msg() {

includes/db/Database.php

Doc Comments +6 added lines, -6 removed lines

@@ -184,7 +184,7 @@ 
 	 *   - false to disable debugging
 	 *   - omitted or null to do nothing
 	 *
-	 * @return bool|null Previous value of the flag
+	 * @return boolean Previous value of the flag
 	 */
 	public function debug( $debug = null ) {
 		return wfSetBit( $this->mFlags, DBO_DEBUG, $debug );
@@ -635,7 +635,7 @@ 
 	}
 
 	/**
-	 * @return bool|string
+	 * @return string|false
 	 */
 	protected function restoreErrorHandler() {
 		restore_error_handler();
@@ -1080,7 +1080,7 @@ 
 	 *
 	 * @param array $options Associative array of options to be turned into
 	 *   an SQL query, valid keys are listed in the function.
-	 * @return array
+	 * @return string[]
 	 * @see DatabaseBase::select()
 	 */
 	public function makeSelectOptions( $options ) {
@@ -2921,8 +2921,8 @@ 
 	 * on object's error ignore settings).
 	 *
 	 * @param string $filename File name to open
-	 * @param bool|callable $lineCallback Optional function called before reading each line
-	 * @param bool|callable $resultCallback Optional function called for each MySQL result
+	 * @param boolean $lineCallback Optional function called before reading each line
+	 * @param boolean $resultCallback Optional function called for each MySQL result
 	 * @param bool|string $fname Calling function name or false if name should be
 	 *   generated dynamically using $filename
 	 * @param bool|callable $inputCallback Optional function called for each
@@ -3235,7 +3235,7 @@ 
 	}
 
 	/**
-	 * @return string|bool Reason this DB is read-only or false if it is not
+	 * @return string|false Reason this DB is read-only or false if it is not
 	 */
 	protected function getReadOnlyReason() {
 		$reason = $this->getLBInfo( 'readOnlyReason' );