From 6488754dadb6349a7ccc32e562e13c2fba54ed63 Mon Sep 17 00:00:00 2001
From: Sam Reed <reedy@users.mediawiki.org>
Date: Thu, 9 Feb 2012 21:17:18 +0000
Subject: [PATCH] More documentation improvements

---
 languages/Language.php          | 10 +++++++---
 languages/LanguageConverter.php |  4 ++--
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/languages/Language.php b/languages/Language.php
index bb9abf16a8..40dcda3008 100644
--- a/languages/Language.php
+++ b/languages/Language.php
@@ -29,6 +29,10 @@ if ( function_exists( 'mb_strtoupper' ) ) {
  * @ingroup Language
  */
 class FakeConverter {
+
+	/**
+	 * @var Language
+	 */
 	var $mLang;
 	function __construct( $langobj ) { $this->mLang = $langobj; }
 	function autoConvertToAllVariants( $text ) { return array( $this->mLang->getCode() => $text ); }
@@ -3131,7 +3135,7 @@ class Language {
 	 * (b) clear $tag value
 	 * @param &$tag string Current HTML tag name we are looking at
 	 * @param $tagType int (0-open tag, 1-close tag)
-	 * @param $lastCh char|string Character before the '>' that ended this tag
+	 * @param $lastCh string Character before the '>' that ended this tag
 	 * @param &$openTags array Open tag stack (not accounting for $tag)
 	 */
 	private function truncate_endBracket( &$tag, $tagType, $lastCh, &$openTags ) {
@@ -3244,7 +3248,7 @@ class Language {
 	 * match up with it.
 	 *
 	 * @param $str String: the validated block duration in English
-	 * @return Somehow translated block duration
+	 * @return string Somehow translated block duration
 	 * @see LanguageFi.php for example implementation
 	 */
 	function translateBlockExpiry( $str ) {
@@ -3583,7 +3587,7 @@ class Language {
 	 *
 	 * @param $code string
 	 *
-	 * @return false|string
+	 * @return bool|string
 	 */
 	public static function getFallbackFor( $code ) {
 		if ( $code === 'en' || !Language::isValidBuiltInCode( $code ) ) {
diff --git a/languages/LanguageConverter.php b/languages/LanguageConverter.php
index 5e4bce8d15..0aaa93135c 100644
--- a/languages/LanguageConverter.php
+++ b/languages/LanguageConverter.php
@@ -1015,8 +1015,8 @@ class LanguageConverter {
 	 * @param $summary String: edit summary of the edit
 	 * @param $isMinor Boolean: was the edit marked as minor?
 	 * @param $isWatch Boolean: did the user watch this page or not?
-	 * @param $section Unused
-	 * @param $flags Bitfield
+	 * @param $section
+	 * @param $flags int Bitfield
 	 * @param $revision Object: new Revision object or null
 	 * @return Boolean: true
 	 */
-- 
2.20.1