Some language love

diff --git a/languages/Language.php b/languages/Language.php
index b64bf00..6b0ba13 100644 (file)
--- a/languages/Language.php
+++ b/languages/Language.php
@@ -1875,6 +1875,9 @@ class Language {
                return $this->iconv( $this->fallback8bitEncoding(), 'utf-8', $s );
        }
 
+       /**
+        * @return array
+        */
        function fallback8bitEncoding() {
                return self::$dataCache->getItem( $this->mCode, 'fallback8bitEncoding' );
        }
@@ -2124,6 +2127,9 @@ class Language {
                return $this->isRTL() ? "\xE2\x80\x8F" : "\xE2\x80\x8E";
        }
 
+       /**
+        * @return array
+        */
        function capitalizeAllNouns() {
                return self::$dataCache->getItem( $this->mCode, 'capitalizeAllNouns' );
        }
@@ -2146,6 +2152,9 @@ class Language {
                return self::$dataCache->getItem( $this->mCode, 'linkPrefixExtension' );
        }
 
+       /**
+        * @return array
+        */
        function getMagicWords() {
                return self::$dataCache->getItem( $this->mCode, 'magicWords' );
        }
@@ -2802,6 +2811,10 @@ class Language {
                return htmlspecialchars( $this->convert( $text, $isTitle ) );
        }
 
+       /**
+        * @param $key string
+        * @return string
+        */
        function convertCategoryKey( $key ) {
                return $this->mConverter->convertCategoryKey( $key );
        }
@@ -2816,14 +2829,23 @@ class Language {
                return $this->mConverter->getVariants();
        }
 
+       /**
+        * @return string
+        */
        function getPreferredVariant() {
                return $this->mConverter->getPreferredVariant();
        }
 
+       /**
+        * @return string
+        */
        function getDefaultVariant() {
                return $this->mConverter->getDefaultVariant();
        }
 
+       /**
+        * @return string
+        */
        function getURLVariant() {
                return $this->mConverter->getURLVariant();
        }
@@ -2898,6 +2920,9 @@ class Language {
                return self::$dataCache->getItem( $this->mCode, 'linkTrail' );
        }
 
+       /**
+        * @return Language
+        */
        function getLangObj() {
                return $this;
        }
@@ -2948,11 +2973,19 @@ class Language {
                return str_replace( '_', '-', strtolower( $m[1] ) );
        }
 
+       /**
+        * @param $code string
+        * @return string
+        */
        static function getMessagesFileName( $code ) {
                global $IP;
                return self::getFileName( "$IP/languages/messages/Messages", $code, '.php' );
        }
 
+       /**
+        * @param $code string
+        * @return string
+        */
        static function getClassFileName( $code ) {
                global $IP;
                return self::getFileName( "$IP/languages/classes/Language", $code, '.php' );
@@ -2960,6 +2993,8 @@ class Language {
 
        /**
         * Get the fallback for a given language
+        *
+        * @return false|string
         */
        static function getFallbackFor( $code ) {
                if ( $code === 'en' ) {

diff --git a/languages/classes/LanguageMy.php b/languages/classes/LanguageMy.php
index 4fa5b05..b12e458 100644 (file)
--- a/languages/classes/LanguageMy.php
+++ b/languages/classes/LanguageMy.php
@@ -7,6 +7,11 @@
  * @author Niklas Laxström, 2008
  */
 class LanguageMy extends Language {
+
+       /**
+        * @param $_ string
+        * @return string
+        */
        function commafy( $_ ) {
                /* NO-op. Cannot use
                 * $separatorTransformTable = array( ',' => '' )

diff --git a/languages/classes/LanguagePl.php b/languages/classes/LanguagePl.php
index 40477f4..59c8d5c 100644 (file)
--- a/languages/classes/LanguagePl.php
+++ b/languages/classes/LanguagePl.php
@@ -5,6 +5,12 @@
  * @ingroup Language
  */
 class LanguagePl extends Language {
+
+       /**
+        * @param $count string
+        * @param $forms array
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                if ( !count( $forms ) ) { return ''; }
                $forms = $this->preConvertPlural( $forms, 3 );
@@ -22,6 +28,10 @@ class LanguagePl extends Language {
                }
        }
 
+       /**
+        * @param $_ string
+        * @return string
+        */
        function commafy( $_ ) {
                if ( !preg_match( '/^\-?\d{1,4}(\.\d+)?$/', $_ ) ) {
                        return strrev( (string)preg_replace( '/(\d{3})(?=\d)(?!\d*\.)/', '$1,', strrev( $_ ) ) );

diff --git a/languages/classes/LanguageRo.php b/languages/classes/LanguageRo.php
index 89edce1..9cfd8b5 100644 (file)
--- a/languages/classes/LanguageRo.php
+++ b/languages/classes/LanguageRo.php
@@ -5,6 +5,12 @@
  * @ingroup Language
  */
 class LanguageRo extends Language {
+
+       /**
+        * @param $count int
+        * @param $forms array
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                // Plural rules per
                // http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html#ro

diff --git a/languages/classes/LanguageSe.php b/languages/classes/LanguageSe.php
index 3011bc7..a66957f 100644 (file)
--- a/languages/classes/LanguageSe.php
+++ b/languages/classes/LanguageSe.php
@@ -5,6 +5,12 @@
  * @ingroup Language
  */
 class LanguageSe extends Language {
+
+       /**
+        * @param $count int
+        * @param $forms array
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                if ( !count( $forms ) ) { return ''; }
 

diff --git a/languages/classes/LanguageSh.php b/languages/classes/LanguageSh.php
index a45258f..139ad0b 100644 (file)
--- a/languages/classes/LanguageSh.php
+++ b/languages/classes/LanguageSh.php
@@ -5,6 +5,12 @@
  * @ingroup Language
  */
 class LanguageSh extends Language {
+
+       /**
+        * @param $count string
+        * @param $forms array
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                if ( !count( $forms ) ) { return ''; }
 

diff --git a/languages/classes/LanguageSk.php b/languages/classes/LanguageSk.php
index ea74d1b..eac25f4 100644 (file)
--- a/languages/classes/LanguageSk.php
+++ b/languages/classes/LanguageSk.php
@@ -5,6 +5,12 @@
  * @ingroup Language
  */
 class LanguageSk extends Language {
+
+       /**
+        * @param $count int
+        * @param $forms array
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                if ( !count( $forms ) ) { return ''; }
                $forms = $this->preConvertPlural( $forms, 3 );

diff --git a/languages/classes/LanguageSl.php b/languages/classes/LanguageSl.php
index 09138ea..66477bb 100644 (file)
--- a/languages/classes/LanguageSl.php
+++ b/languages/classes/LanguageSl.php
@@ -26,6 +26,12 @@ class LanguageSl extends Language {
                return $word; # this will return the original value for 'imenovalnik' (nominativ) and all undefined case values
        }
 
+       /**
+        * @param $count int
+        * @param $forms array
+        *
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                if ( !count( $forms ) ) { return ''; }
                $forms = $this->preConvertPlural( $forms, 5 );

diff --git a/languages/classes/LanguageSma.php b/languages/classes/LanguageSma.php
index a04c77d..fa6d32a 100644 (file)
--- a/languages/classes/LanguageSma.php
+++ b/languages/classes/LanguageSma.php
@@ -5,6 +5,12 @@
  * @ingroup Language
  */
 class LanguageSma extends Language {
+
+       /**
+        * @param $count int
+        * @param $forms array
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                if ( !count( $forms ) ) { return ''; }
 

diff --git a/languages/classes/LanguageSr.php b/languages/classes/LanguageSr.php
index e61f579..a75b6a1 100644 (file)
--- a/languages/classes/LanguageSr.php
+++ b/languages/classes/LanguageSr.php
@@ -197,6 +197,12 @@ class LanguageSr extends LanguageSr_ec {
                $wgHooks['ArticleSaveComplete'][] = $this->mConverter;
        }
 
+       /**
+        * @param $count int
+        * @param $forms array
+        *
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                if ( !count( $forms ) ) {
                        return '';

diff --git a/languages/classes/LanguageSr_ec.php b/languages/classes/LanguageSr_ec.php
index ed447e5..572a5f3 100644 (file)
--- a/languages/classes/LanguageSr_ec.php
+++ b/languages/classes/LanguageSr_ec.php
@@ -6,6 +6,12 @@
  * @ingroup Language
  */
 class LanguageSr_ec extends Language {
+
+       /**
+        * @param $count int
+        * @param $forms array
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                if ( !count( $forms ) ) { return ''; }
                $forms = $this->preConvertPlural( $forms, 3 );

diff --git a/languages/classes/LanguageSr_el.php b/languages/classes/LanguageSr_el.php
index d43772a..3a1f6a6 100644 (file)
--- a/languages/classes/LanguageSr_el.php
+++ b/languages/classes/LanguageSr_el.php
@@ -6,6 +6,12 @@
  * @ingroup Language
  */
 class LanguageSr_el extends Language {
+
+       /**
+        * @param $count int
+        * @param $forms array
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                if ( !count( $forms ) ) { return ''; }
                $forms = $this->preConvertPlural( $forms, 3 );

diff --git a/languages/classes/LanguageUk.php b/languages/classes/LanguageUk.php
index c1b1e56..06dfb57 100644 (file)
--- a/languages/classes/LanguageUk.php
+++ b/languages/classes/LanguageUk.php
@@ -56,6 +56,11 @@ class LanguageUk extends Language {
                return $word;
        }
 
+       /**
+        * @param $count int
+        * @param $forms array
+        * @return string
+        */
        function convertPlural( $count, $forms ) {
                if ( !count( $forms ) ) { return ''; }
 

diff --git a/languages/classes/LanguageYue.php b/languages/classes/LanguageYue.php
index 537ffc1..5492529 100644 (file)
--- a/languages/classes/LanguageYue.php
+++ b/languages/classes/LanguageYue.php
@@ -5,6 +5,10 @@
  * @ingroup Language
  */
 class LanguageYue extends Language {
+
+       /**
+        * @return bool
+        */
        function hasWordBreaks() {
                return false;
        }
@@ -13,6 +17,9 @@ class LanguageYue extends Language {
         * Eventually this should be a word segmentation;
         * for now just treat each character as a word.
         * @todo FIXME: Only do this for Han characters...
+        *
+        * @param $string string
+        * @return string
         */
        function segmentByWord( $string ) {
                $reg = "/([\\xc0-\\xff][\\x80-\\xbf]*)/";

diff --git a/languages/classes/LanguageZh_hans.php b/languages/classes/LanguageZh_hans.php
index 2fcb7de..671a16e 100644 (file)
--- a/languages/classes/LanguageZh_hans.php
+++ b/languages/classes/LanguageZh_hans.php
@@ -6,6 +6,10 @@
  * @ingroup Language
  */
 class LanguageZh_hans extends Language {
+
+       /**
+        * @return bool
+        */
        function hasWordBreaks() {
                return false;
        }
@@ -14,6 +18,10 @@ class LanguageZh_hans extends Language {
         * Eventually this should be a word segmentation;
         * for now just treat each character as a word.
         * @todo FIXME: Only do this for Han characters...
+        *
+        * @param $string string
+        *
+        * @return string
         */
        function segmentByWord( $string ) {
                $reg = "/([\\xc0-\\xff][\\x80-\\xbf]*)/";