wikimedia / mediawiki

includes/utils/AvroValidator.php

Doc Comments +6 added lines

@@ -171,10 +171,16 @@
 		return is_object( $datum ) ? get_class( $datum ) : gettype( $datum );
 	}
 
+	/**
+	 * @param string $expected
+	 */
 	public static function wrongType( $expected, $datum ) {
 		return "Expected $expected, but recieved " . self::typeOf( $datum );
 	}
 
+	/**
+	 * @param integer $datum
+	 */
 	public static function outOfRange( $min, $max, $datum ) {
 		return "Expected value between $min and $max, but recieved $datum";
 	}

includes/utils/UIDGenerator.php

Doc Comments +3 added lines, -3 removed lines

@@ -510,8 +510,8 @@ 
 	 * Wait till the current timestamp reaches $time and return the current
 	 * timestamp. This returns false if it would have to wait more than 10ms.
 	 *
-	 * @param array $time Result of UIDGenerator::millitime()
-	 * @return array|bool UIDGenerator::millitime() result or false
+	 * @param integer[] $time Result of UIDGenerator::millitime()
+	 * @return resource UIDGenerator::millitime() result or false
 	 */
 	protected function timeWaitUntil( array $time ) {
 		do {
@@ -571,7 +571,7 @@ 
 	}
 
 	/**
-	 * @return array (current time in seconds, milliseconds since then)
+	 * @return integer[] (current time in seconds, milliseconds since then)
 	 */
 	protected static function millitime() {
 		list( $msec, $sec ) = explode( ' ', microtime() );

includes/utils/ZipDirectoryReader.php

Doc Comments +1 added lines, -1 removed lines

@@ -184,7 +184,7 @@
 
 	/**
 	 * Throw an error, and log a debug message
-	 * @param mixed $code
+	 * @param string $code
 	 * @param string $debugMessage
 	 * @throws ZipDirectoryReaderError
 	 */

includes/widget/ComplexNamespaceInputWidget.php

Doc Comments -14 removed lines

@@ -22,20 +22,6 @@
 
 	/**
 	 * @param array $config Configuration options
-	 * @param array $config['namespace'] Configuration for the NamespaceInputWidget
-	 *  dropdown with list of namespaces
-	 * @param string $config['namespace']['includeAllValue'] If specified,
-	 *  add an "all namespaces" option to the dropdown, and use this as the input value for it
-	 * @param array|null $config['invert'] Configuration for the "invert selection"
-	 *  CheckboxInputWidget. If null, the checkbox will not be generated.
-	 * @param array|null $config['associated'] Configuration for the "include associated namespace"
-	 *  CheckboxInputWidget. If null, the checkbox will not be generated.
-	 * @param array $config['invertLabel'] Configuration for the FieldLayout with label
-	 *  wrapping the "invert selection" checkbox
-	 * @param string $config['invertLabel']['label'] Label text for the label
-	 * @param array $config['associatedLabel'] Configuration for the FieldLayout with label
-	 *  wrapping the "include associated namespace" checkbox
-	 * @param string $config['associatedLabel']['label'] Label text for the label
 	 */
 	public function __construct( array $config = array() ) {
 		// Configuration initialization

includes/widget/ComplexTitleInputWidget.php

Doc Comments -3 removed lines

@@ -19,9 +19,6 @@
 	 * Like TitleInputWidget, but the namespace has to be input through a separate dropdown field.
 	 *
 	 * @param array $config Configuration options
-	 * @param array $config['namespace'] Configuration for the NamespaceInputWidget dropdown
-	 *  with list of namespaces
-	 * @param array $config['title'] Configuration for the TitleInputWidget text field
 	 */
 	public function __construct( array $config = array() ) {
 		// Configuration initialization

includes/widget/NamespaceInputWidget.php

Doc Comments -3 removed lines

@@ -16,9 +16,6 @@
 
 	/**
 	 * @param array $config Configuration options
-	 * @param string $config['includeAllValue'] If specified, add a "all namespaces" option to the
-	 *     namespace dropdown, and use this as the input value for it
-	 * @param number[] $config['exclude'] List of namespace numbers to exclude from the selector
 	 */
 	public function __construct( array $config = array() ) {
 		// Configuration initialization

includes/widget/TitleInputWidget.php

Doc Comments -8 removed lines

@@ -20,14 +20,6 @@
 
 	/**
 	 * @param array $config Configuration options
-	 * @param int|null $config['namespace'] Namespace to prepend to queries
-	 * @param bool|null $config['relative'] If a namespace is set,
-	 *  return a title relative to it (default: true)
-	 * @param bool|null $config['suggestions'] Display search suggestions (default: true)
-	 * @param bool|null $config['highlightFirst'] Automatically highlight
-	 *  the first result (default: true)
-	 * @param bool|null $config['validateTitle'] Whether the input must
-	 *  be a valid title (default: true)
 	 */
 	public function __construct( array $config = array() ) {
 		// Parent constructor

includes/WikiMap.php

Doc Comments +2 added lines, -2 removed lines

@@ -109,7 +109,7 @@ 
 	 *
 	 * @todo We can give more info than just the wiki id!
 	 * @param string $wikiID Wiki'd id (generally database name)
-	 * @return string|int Wiki's name or $wiki_id if the wiki was not found
+	 * @return string|null Wiki's name or $wiki_id if the wiki was not found
 	 */
 	public static function getWikiName( $wikiID ) {
 		$wiki = WikiMap::getWiki( $wikiID );
@@ -160,7 +160,7 @@ 
 	 * @param string $page Page name (must be normalised before calling this function!)
 	 * @param string|null $fragmentId
 	 *
-	 * @return string|bool URL or false if the wiki was not found
+	 * @return string|false URL or false if the wiki was not found
 	 */
 	public static function getForeignURL( $wikiID, $page, $fragmentId = null ) {
 		$wiki = WikiMap::getWiki( $wikiID );

includes/Xml.php

Doc Comments +4 added lines, -4 removed lines

@@ -199,7 +199,7 @@ 
 	 * @param string $inLanguage The ISO code of the language to display the select list in (optional)
 	 * @param array $overrideAttrs Override the attributes of the select tag (since 1.20)
 	 * @param Message|null $msg Label message key (since 1.20)
-	 * @return array Array containing 2 items: label HTML and select list HTML
+	 * @return string[] Array containing 2 items: label HTML and select list HTML
 	 */
 	public static function languageSelector( $selected, $customisedOnly = true,
 		$inLanguage = null, $overrideAttrs = array(), Message $msg = null
@@ -373,7 +373,7 @@ 
 	 * @param string $label Text of the label
 	 * @param string $name Value of the name attribute
 	 * @param string $id Id of the input
-	 * @param int|bool $size Value of the size attribute
+	 * @param integer $size Value of the size attribute
 	 * @param string|bool $value Value of the value attribute
 	 * @param array $attribs Other attributes
 	 * @return string HTML
@@ -395,7 +395,7 @@ 
 	 * @param string|bool $value
 	 * @param array $attribs
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	public static function inputLabelSep( $label, $name, $id, $size = false,
 		$value = false, $attribs = array()
@@ -677,7 +677,7 @@ 
 	 *    which evaluates to a function object which is called.
 	 * @param array $args The arguments to pass to the function.
 	 * @param bool $pretty If true, add non-significant whitespace to improve readability.
-	 * @return string|bool String if successful; false upon failure
+	 * @return false|string String if successful; false upon failure
 	 */
 	public static function encodeJsCall( $name, $args, $pretty = false ) {
 		foreach ( $args as &$arg ) {