wikimedia / mediawiki

includes/deferred/LinksUpdate.php

Doc Comments +2 added lines, -2 removed lines

@@ -167,7 +167,7 @@ 
 	 *
 	 * @param IDatabase $dbw
 	 * @param integer $pageId
-	 * @return ScopedCallback|null Returns null on failure
+	 * @return ScopedCallback Returns null on failure
 	 * @throws RuntimeException
 	 * @since 1.27
 	 */
@@ -935,7 +935,7 @@ 
 
 	/**
 	 * @since 1.28
-	 * @return null|Revision
+	 * @return Revision
 	 */
 	public function getRevision() {
 		return $this->mRevision;

includes/resourceloader/ResourceLoaderFileModule.php

Doc Comments +3 added lines, -2 removed lines

@@ -381,7 +381,7 @@ 
 	 * Get all styles for a given context.
 	 *
 	 * @param ResourceLoaderContext $context
-	 * @return array CSS code for $context as an associative array mapping media type to CSS text.
+	 * @return string CSS code for $context as an associative array mapping media type to CSS text.
 	 */
 	public function getStyles( ResourceLoaderContext $context ) {
 		$styles = $this->readStyleFiles(
@@ -631,7 +631,7 @@ 
 	 * @param array $list List of file paths in any combination of index/path
 	 *     or path/options pairs
 	 * @param string $option Option name
-	 * @param mixed $default Default value if the option isn't set
+	 * @param string $default Default value if the option isn't set
 	 * @return array List of file paths, collated by $option
 	 */
 	protected static function collateFilePathListByOption( array $list, $option, $default ) {
@@ -1007,6 +1007,7 @@ 
 	 * the BOM character is not valid in the middle of a string.
 	 * We already assume UTF-8 everywhere, so this should be safe.
 	 *
+	 * @param string $input
 	 * @return string input minus the intial BOM char
 	 */
 	protected function stripBom( $input ) {

includes/search/SearchEngine.php

Doc Comments +7 added lines, -6 removed lines

@@ -104,7 +104,7 @@ 
 	 * @since 1.18
 	 * @param string $feature
 	 * @param mixed $data
-	 * @return bool
+	 * @return boolean|null
 	 */
 	public function setFeatureData( $feature, $data ) {
 		$this->features[$feature] = $data;
@@ -301,7 +301,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. :)
@@ -507,6 +507,7 @@ 
 	 * Process completion search results.
 	 * Resolves the titles and rescores.
 	 * @param SearchSuggestionSet $suggestions
+	 * @param string $search
 	 * @return SearchSuggestionSet
 	 */
 	protected function processCompletionResults( $search, SearchSuggestionSet $suggestions ) {
@@ -590,7 +591,7 @@ 
 	 * settings, returning a list of index numbers.
 	 * @deprecated since 1.27; use SearchEngineConfig::userNamespaces()
 	 * @param user $user
-	 * @return array
+	 * @return integer[]
 	 */
 	public static function userNamespaces( $user ) {
 		return MediaWikiServices::getInstance()->getSearchEngineConfig()->userNamespaces( $user );
@@ -599,7 +600,7 @@ 
 	/**
 	 * An array of namespaces indexes to be searched by default
 	 * @deprecated since 1.27; use SearchEngineConfig::defaultNamespaces()
-	 * @return array
+	 * @return integer[]
 	 */
 	public static function defaultNamespaces() {
 		return MediaWikiServices::getInstance()->getSearchEngineConfig()->defaultNamespaces();
@@ -610,7 +611,7 @@ 
 	 * and preferences
 	 * @deprecated since 1.27; use SearchEngineConfig::namespacesAsText()
 	 * @param array $namespaces
-	 * @return array
+	 * @return string[]
 	 */
 	public static function namespacesAsText( $namespaces ) {
 		return MediaWikiServices::getInstance()->getSearchEngineConfig()->namespacesAsText( $namespaces );
@@ -648,7 +649,7 @@ 
 	 * - default: set to true if this profile is the default
 	 *
 	 * @since 1.28
-	 * @param $profileType the type of profiles
+	 * @param string $profileType the type of profiles
 	 * @return array|null the list of profiles or null if none available
 	 */
 	public function getProfiles( $profileType ) {

includes/deferred/LinksDeletionUpdate.php

Doc Comments +3 added lines

@@ -163,6 +163,9 @@
 		} );
 	}
 
+	/**
+	 * @param string $table
+	 */
 	private function batchDeleteByPK( $table, array $conds, array $pk, $bSize ) {
 		$dbw = $this->mDb; // convenience
 		$res = $dbw->select( $table, $pk, $conds, __METHOD__ );

includes/session/SessionManager.php

Doc Comments +1 added lines, -1 removed lines

@@ -77,7 +77,7 @@
 
 	/**
 	 * Get the global SessionManager
-	 * @return SessionManagerInterface
+	 * @return User
 	 *  (really a SessionManager, but this is to make IDEs less confused)
 	 */
 	public static function singleton() {