wikimedia / mediawiki

includes/HistoryBlob.php

Doc Comments +5 added lines, -4 removed lines

@@ -55,6 +55,7 @@ 
 	 * Default text is not required for two-part external storage URLs.
 	 *
 	 * @param string $text
+	 * @return void
 	 */
 	function setText( $text );
 
@@ -161,7 +162,7 @@ 
 	}
 
 	/**
-	 * @return array
+	 * @return string[]
 	 */
 	function __sleep() {
 		$this->compress();
@@ -531,7 +532,7 @@ 
 	/**
 	 * @param string $base
 	 * @param string $diff
-	 * @return bool|string
+	 * @return string|false
 	 */
 	function patch( $base, $diff ) {
 		if ( function_exists( 'xdiff_string_bpatch' ) ) {
@@ -593,7 +594,7 @@ 
 	 * the bytes backwards and initialised with 0 instead of 1. See bug 34428.
 	 *
 	 * @param string $s
-	 * @return string|bool False if the hash extension is not available
+	 * @return false|string False if the hash extension is not available
 	 */
 	function xdiffAdler32( $s ) {
 		if ( !function_exists( 'hash' ) ) {
@@ -626,7 +627,7 @@ 
 	}
 
 	/**
-	 * @return array
+	 * @return string[]
 	 */
 	function __sleep() {
 		$this->compress();

includes/htmlform/HTMLButtonField.php

Doc Comments +1 added lines, -1 removed lines

@@ -125,7 +125,7 @@
 
 	/**
 	 * IE<8 has bugs with <button>, so we'll need to avoid them.
-	 * @return bool Whether the request is from a bad version of IE
+	 * @return integer Whether the request is from a bad version of IE
 	 */
 	private function isBadIE() {
 		$request = $this->mParent

includes/htmlform/HTMLCheckMatrix.php

Doc Comments +4 added lines, -1 removed lines

@@ -75,7 +75,7 @@ 
 	 * mParams['rows'] is an array with row labels as keys and row tags as values.
 	 * mParams['columns'] is an array with column labels as keys and column tags as values.
 	 *
-	 * @param array $value Array of the options that should be checked
+	 * @param string $value Array of the options that should be checked
 	 *
 	 * @return string
 	 */
@@ -151,6 +151,9 @@ 
 		return $html;
 	}
 
+	/**
+	 * @param boolean $checked
+	 */
 	protected function getOneCheckbox( $checked, $attribs ) {
 		if ( $this->mParent instanceof OOUIHTMLForm ) {
 			return new OOUI\CheckboxInputWidget( array(

includes/htmlform/HTMLForm.php

Doc Comments +1 added lines, -2 removed lines

@@ -250,7 +250,6 @@ 
 	 * Construct a HTMLForm object for given display type. May return a HTMLForm subclass.
 	 *
 	 * @param string $displayFormat
-	 * @param mixed $arguments... Additional arguments to pass to the constructor.
 	 * @return HTMLForm
 	 */
 	public static function factory( $displayFormat/*, $arguments...*/ ) {
@@ -1359,7 +1358,7 @@ 
 	 * this message as its "<legend>" element.
 	 * @since 1.19
 	 *
-	 * @param string|Message $msg Message key or Message object
+	 * @param string $msg Message key or Message object
 	 *
 	 * @return HTMLForm $this for chaining calls (since 1.20)
 	 */

includes/htmlform/HTMLFormField.php

Doc Comments +9 added lines, -3 removed lines

@@ -49,7 +49,7 @@ 
 	 * Defaults to false, which getOOUI will interpret as "use the HTML version"
 	 *
 	 * @param string $value
-	 * @return OOUI\Widget|false
+	 * @return boolean
 	 */
 	function getInputOOUI( $value ) {
 		return false;
@@ -318,6 +318,9 @@ 
 		return true;
 	}
 
+	/**
+	 * @param HTMLFormField[] $alldata
+	 */
 	function filter( $value, $alldata ) {
 		if ( isset( $this->mFilterCallback ) ) {
 			$value = call_user_func( $this->mFilterCallback, $value, $alldata, $this->mParent );
@@ -803,7 +806,7 @@ 
 	 * @since 1.20
 	 *
 	 * @param string $value The value of the input
-	 * @return array array( $errors, $errorClass )
+	 * @return string[] array( $errors, $errorClass )
 	 */
 	public function getErrorsAndErrorClass( $value ) {
 		$errors = $this->validate( $value, $this->mParent->mFieldData );
@@ -891,6 +894,9 @@ 
 		return $html;
 	}
 
+	/**
+	 * @return string
+	 */
 	function getDefault() {
 		if ( isset( $this->mDefault ) ) {
 			return $this->mDefault;
@@ -1086,7 +1092,7 @@ 
 	/**
 	 * Formats one or more errors as accepted by field validation-callback.
 	 *
-	 * @param string|Message|array $errors Array of strings or Message instances
+	 * @param string $errors Array of strings or Message instances
 	 * @return string HTML
 	 * @since 1.18
 	 */

includes/htmlform/HTMLMultiSelectField.php

Doc Comments +3 added lines

@@ -63,6 +63,9 @@
 		return $html;
 	}
 
+	/**
+	 * @param boolean $checked
+	 */
 	protected function getOneCheckbox( $checked, $attribs, $label ) {
 		if ( $this->mParent instanceof OOUIHTMLForm ) {
 			if ( $this->mOptionsLabelsNotFromMessage ) {

includes/htmlform/HTMLRadioField.php

Doc Comments +3 added lines

@@ -55,6 +55,9 @@
 		) + $this->getAttributes( array( 'disabled', 'tabindex' ), array( 'tabindex' => 'tabIndex' ) ) );
 	}
 
+	/**
+	 * @param string $value
+	 */
 	function formatOptions( $options, $value ) {
 		$html = '';
 

includes/htmlform/OOUIHTMLForm.php

Doc Comments +1 added lines, -1 removed lines

@@ -155,7 +155,7 @@
 	 * @param OOUI\FieldLayout[] $fieldsHtml
 	 * @param string $sectionName
 	 * @param bool $anyFieldHasLabel Unused
-	 * @return string HTML
+	 * @return OOUI\FieldsetLayout HTML
 	 */
 	protected function formatSection( array $fieldsHtml, $sectionName, $anyFieldHasLabel ) {
 		$config = array(

includes/HttpFunctions.php

Doc Comments +2 added lines, -2 removed lines

@@ -186,7 +186,7 @@ 
 	 * @todo FIXME this is wildly inaccurate and fails to actually check most stuff
 	 *
 	 * @param string $uri URI to check for validity
-	 * @return bool
+	 * @return integer
 	 */
 	public static function isValidURI( $uri ) {
 		return preg_match(
@@ -317,7 +317,7 @@ 
 	 * @param array $options (optional) extra params to pass (see Http::request())
 	 * @param string $caller The method making this request, for profiling
 	 * @throws MWException
-	 * @return CurlHttpRequest|PhpHttpRequest
+	 * @return string
 	 * @see MWHttpRequest::__construct
 	 */
 	public static function factory( $url, $options = null, $caller = __METHOD__ ) {