wikimedia / mediawiki

includes/Revision.php

Doc Comments +9 added lines, -9 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 [
@@ -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 [
@@ -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 [ '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() {
@@ -1758,7 +1758,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 )
@@ -1814,7 +1814,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/cache/localisation/LCStoreCDB.php

Doc Comments +5 added lines

@@ -130,6 +130,11 @@
 		}
 	}
 
+	/**
+	 * @param string $code
+	 *
+	 * @return string
+	 */
 	protected function getFileName( $code ) {
 		if ( strval( $code ) === '' || strpos( $code, '/' ) !== false ) {
 			throw new MWException( __METHOD__ . ": Invalid language \"$code\"" );

includes/cache/localisation/LocalisationCache.php

Doc Comments +1 added lines, -1 removed lines

@@ -691,7 +691,7 @@
 	 *
 	 * @param string $code
 	 * @param array $deps
-	 * @return array
+	 * @return string
 	 */
 	protected function readSourceFilesAndRegisterDeps( $code, &$deps ) {
 		global $IP;

includes/specials/pagers/AllMessagesTablePager.php

Doc Comments +11 added lines, -1 removed lines

@@ -97,6 +97,10 @@ 
 	 */
 	public $custom;
 
+	/**
+	 * @param SpecialAllMessages $page
+	 * @param Language $langObj
+	 */
 	function __construct( $page, $conds, $langObj = null ) {
 		parent::__construct( $page->getContext() );
 		$this->mIndexField = 'am_title';
@@ -223,6 +227,9 @@ 
 		return $out;
 	}
 
+	/**
+	 * @param boolean $descending
+	 */
 	function getAllMessages( $descending ) {
 		$messageNames = Language::getLocalisationCache()->getSubitemList( 'en', 'messages' );
 
@@ -247,7 +254,7 @@ 
 	 * @param array $messageNames
 	 * @param string $langcode What language code
 	 * @param bool $foreign Whether the $langcode is not the content language
-	 * @return array A 'pages' and 'talks' array with the keys of existing pages
+	 * @return string A 'pages' and 'talks' array with the keys of existing pages
 	 */
 	public static function getCustomisedStatuses( $messageNames, $langcode = 'en', $foreign = false ) {
 		// FIXME: This function should be moved to Language:: or something.
@@ -439,6 +446,9 @@ 
 		return $arr;
 	}
 
+	/**
+	 * @param string $field
+	 */
 	function getCellAttrs( $field, $value ) {
 		if ( $this->mCurrentRow->am_customised && $field === 'am_title' ) {
 			return array( 'rowspan' => '2', 'class' => $field );

includes/specials/pagers/CategoryPager.php

Doc Comments +3 added lines

@@ -179,6 +179,9 @@
 		return Html::rawElement( 'li', null, $this->getLanguage()->specialList( $link, $count ) ) . "\n";
 	}
 
+	/**
+	 * @param string $from
+	 */
 	public function getStartForm( $from ) {
 		return Xml::tags(
 			'form',

includes/specials/pagers/DeletedContribsPager.php

Doc Comments +3 added lines

@@ -35,6 +35,9 @@
 	 */
 	protected $mNavigationBar;
 
+	/**
+	 * @param string|null $target
+	 */
 	function __construct( IContextSource $context, $target, $namespace = false ) {
 		parent::__construct( $context );
 		$msgs = [ 'deletionlog', 'undeleteviewlink', 'diff' ];

includes/specials/pagers/NewPagesPager.php

Doc Comments +3 added lines

@@ -32,6 +32,9 @@
 	 */
 	protected $mForm;
 
+	/**
+	 * @param SpecialNewpages $form
+	 */
 	function __construct( $form, FormOptions $opts ) {
 		parent::__construct( $form->getContext() );
 		$this->mForm = $form;

includes/specials/pagers/ProtectedTitlesPager.php

Doc Comments +6 added lines

@@ -198,6 +198,12 @@
 class ProtectedTitlesPager extends AlphabeticPager {
 	public $mForm, $mConds;
 
+	/**
+	 * @param SpecialProtectedtitles $form
+	 * @param null|string $type
+	 * @param null|string $level
+	 * @param integer|null $namespace
+	 */
 	function __construct( $form, $conds = array(), $type, $level, $namespace,
 		$sizetype = '', $size = 0
 	) {

includes/specials/SpecialDeletedContributions.php

Doc Comments +1 added lines, -1 removed lines

@@ -128,7 +128,7 @@
 	/**
 	 * Generates the subheading with links
 	 * @param User $userObj User object for the target
-	 * @return string Appropriately-escaped HTML to be output literally
+	 * @return Message Appropriately-escaped HTML to be output literally
 	 * @todo FIXME: Almost the same as contributionsSub in SpecialContributions.php. Could be combined.
 	 */
 	function getSubTitle( $userObj ) {