wikimedia / mediawiki

includes/api/ApiErrorFormatter.php

Doc Comments +2 added lines, -2 removed lines

@@ -70,7 +70,7 @@ 
 	/**
 	 * Add a warning to the result
 	 * @param string $moduleName
-	 * @param MessageSpecifier|array|string $msg i18n message for the warning
+	 * @param ApiRawMessage $msg i18n message for the warning
 	 * @param string $code Machine-readable code for the warning. Defaults as
 	 *   for IApiMessage::getApiCode().
 	 * @param array $data Machine-readable data for the warning, if any.
@@ -181,7 +181,7 @@ 
 	 * Actually add the warning or error to the result
 	 * @param string $tag 'warning' or 'error'
 	 * @param string $moduleName
-	 * @param ApiMessage|ApiRawMessage $msg
+	 * @param Message $msg
 	 */
 	protected function addWarningOrError( $tag, $moduleName, $msg ) {
 		$value = array( 'code' => $msg->getApiCode() );

includes/api/ApiFormatXml.php

Doc Comments +3 added lines

@@ -39,6 +39,9 @@
 		return 'text/xml';
 	}
 
+	/**
+	 * @param string $rootElemName
+	 */
 	public function setRootElement( $rootElemName ) {
 		$this->mRootElemName = $rootElemName;
 	}

includes/api/ApiMessage.php

Doc Comments +2 added lines

@@ -53,12 +53,14 @@
 	 * Sets the machine-readable code for use by the API
 	 * @param string|null $code If null, the message key should be returned by self::getApiCode()
 	 * @param array|null $data If non-null, passed to self::setApiData()
+	 * @return void
 	 */
 	public function setApiCode( $code, array $data = null );
 
 	/**
 	 * Sets additional machine-readable data about the error condition
 	 * @param array $data
+	 * @return void
 	 */
 	public function setApiData( array $data );
 }

includes/api/ApiOpenSearch.php

Doc Comments +3 added lines

@@ -377,6 +377,9 @@
 class ApiOpenSearchFormatJson extends ApiFormatJson {
 	private $warningsAsError = false;
 
+	/**
+	 * @param string $fm
+	 */
 	public function __construct( ApiMain $main, $fm, $warningsAsError ) {
 		parent::__construct( $main, "json$fm" );
 		$this->warningsAsError = $warningsAsError;

includes/api/ApiPageSet.php

Doc Comments +1 added lines, -1 removed lines

@@ -576,7 +576,7 @@
 	/**
 	 * Get an array of invalid/special/missing titles.
 	 *
-	 * @param array $invalidChecks List of types of invalid titles to include.
+	 * @param string[] $invalidChecks List of types of invalid titles to include.
 	 *   Recognized values are:
 	 *   - invalidTitles: Titles and reasons from $this->getInvalidTitlesAndReasons()
 	 *   - special: Titles from $this->getSpecialTitles()

includes/api/ApiParse.php

Doc Comments +1 added lines, -1 removed lines

@@ -560,7 +560,7 @@
 	 *
 	 * @param Title $title of the page being parsed
 	 * @param Array $params the API parameters of the request
-	 * @return Content|bool
+	 * @return string
 	 */
 	private function formatSummary( $title, $params ) {
 		global $wgParser;

includes/api/ApiQueryBase.php

Doc Comments +3 added lines, -3 removed lines

@@ -118,7 +118,7 @@ 
 	 * See ApiQuery::getNamedDB() for more information
 	 * @param string $name Name to assign to the database connection
 	 * @param int $db One of the DB_* constants
-	 * @param array $groups Query groups
+	 * @param string $groups Query groups
 	 * @return DatabaseBase
 	 */
 	public function selectNamedDB( $name, $db, $groups ) {
@@ -552,7 +552,7 @@ 
 
 	/**
 	 * @param string $hash
-	 * @return bool
+	 * @return integer
 	 */
 	public function validateSha1Hash( $hash ) {
 		return preg_match( '/^[a-f0-9]{40}$/', $hash );
@@ -560,7 +560,7 @@ 
 
 	/**
 	 * @param string $hash
-	 * @return bool
+	 * @return integer
 	 */
 	public function validateSha1Base36Hash( $hash ) {
 		return preg_match( '/^[a-z0-9]{31}$/', $hash );

includes/api/ApiQueryCategoryMembers.php

Doc Comments +1 added lines, -1 removed lines

@@ -49,7 +49,7 @@
 
 	/**
 	 * @param string $hexSortkey
-	 * @return bool
+	 * @return integer
 	 */
 	private function validateHexSortkey( $hexSortkey ) {
 		// A hex sortkey has an unbound number of 2 letter pairs

includes/api/ApiQueryExtLinksUsage.php

Doc Comments +3 added lines

@@ -202,6 +202,9 @@
 		return $protocols;
 	}
 
+	/**
+	 * @return string|null
+	 */
 	public static function getProtocolPrefix( $protocol ) {
 		// Find the right prefix
 		global $wgUrlProtocols;