More return type documentation

includes/MagicWord.php

@@ -192,6 +192,7 @@ class MagicWord {
 	/**
 	 * Factory: creates an object representing an ID
 	 * @static
+	 * @return MagicWord
 	 */
 	static function &get( $id ) {
 		wfProfileIn( __METHOD__ );

includes/parser/CoreParserFunctions.php

@@ -10,6 +10,11 @@
  * @ingroup Parser
  */
 class CoreParserFunctions {
+	/**
+	 * @static
+	 * @param $parser Parser
+	 * @return void
+	 */
 	static function register( $parser ) {
 		global $wgAllowDisplayTitle, $wgAllowSlowParserFunctions;
 
@@ -507,6 +512,7 @@ class CoreParserFunctions {
 	 *   to the link cache, so the local cache here should be unnecessary, but
 	 *   in fact calling getLength() repeatedly for the same $page does seem to
 	 *   run one query for each call?
+	 * @param $parser Parser
 	 */
 	static function pagesize( $parser, $page = '', $raw = null ) {
 		static $cache = array();
@@ -584,6 +590,12 @@ class CoreParserFunctions {
 		return self::pad( $string, $length, $padding );
 	}
 
+	/**
+	 * @static
+	 * @param $parser Parser
+	 * @param  $text
+	 * @return string
+	 */
 	static function anchorencode( $parser, $text ) {
 		return substr( $parser->guessSectionNameFromWikiText( $text ), 1);
 	}
@@ -598,6 +610,12 @@ class CoreParserFunctions {
 		}
 	}
 
+	/**
+	 * @static
+	 * @param $parser Parser
+	 * @param  $text
+	 * @return string
+	 */
 	public static function defaultsort( $parser, $text ) {
 		$text = trim( $text );
 		if( strlen( $text ) == 0 )

includes/parser/CoreTagHooks.php

@@ -10,6 +10,11 @@
  * @ingroup Parser
  */
 class CoreTagHooks {
+	/**
+	 * @static
+	 * @param $parser Parser
+	 * @return void
+	 */
 	static function register( $parser ) {
 		global $wgRawHtml, $wgUseTeX;
 		$parser->setHook( 'pre', array( __CLASS__, 'pre' ) );
@@ -52,6 +57,13 @@ class CoreTagHooks {
 		return $wgContLang->armourMath( MathRenderer::renderMath( $content, $attributes, $parser->getOptions() ) );
 	}
 
+	/**
+	 * @static
+	 * @param  $content
+	 * @param  $attributes
+	 * @param $parser Parser
+	 * @return
+	 */
 	static function gallery( $content, $attributes, $parser ) {
 		return $parser->renderImageGallery( $content, $attributes );
 	}

includes/parser/LinkHolderArray.php

@@ -28,6 +28,7 @@ class LinkHolderArray {
 
 	/**
 	 * Merge another LinkHolderArray into this one
+	 * @param $other LinkHolderArray
 	 */
 	function merge( $other ) {
 		foreach ( $other->internals as $ns => $entries ) {

includes/parser/Parser_DiffTest.php

@@ -111,6 +111,10 @@ class Parser_DiffTest
 		}
 	}
 
+	/**
+	 * @param $parser Parser
+	 * @return bool
+	 */
 	function onClearState( &$parser ) {
 		// hack marker prefixes to get identical output
 		if ( !isset( $this->dtUniqPrefix ) ) {