From: kaldari <rkaldari@wikimedia.org>
Date: Tue, 1 Apr 2014 00:31:06 +0000 (-0700)
Subject: Cleaning up function definitions in Language.php
X-Git-Tag: 1.31.0-rc.0~16396^2
X-Git-Url: http://git.cyclocoop.org//%27http:/code.google.com/p/ie7-js//%27?a=commitdiff_plain;h=4cd2d675476df7987e885f9051ab443c6d3b2cb7;p=lhc%2Fweb%2Fwiklou.git

Cleaning up function definitions in Language.php

Some of these were confusing or incorrect.

Change-Id: I2dd02669a7cf9d8b92e2d5c1b86ab8c5e0cbf6bd
---

diff --git a/languages/Language.php b/languages/Language.php
index fcb0f097d7..fb73b1e436 100644
--- a/languages/Language.php
+++ b/languages/Language.php
@@ -609,6 +609,7 @@ class Language {
 
 	/**
 	 * Returns gender-dependent namespace alias if available.
+	 * See https://www.mediawiki.org/wiki/Manual:$wgExtraGenderNamespaces
 	 * @param $index Int: namespace index
 	 * @param $gender String: gender key (male, female... )
 	 * @return String
@@ -622,8 +623,8 @@ class Language {
 	}
 
 	/**
-	 * Whether this language makes distinguishes genders for example in
-	 * namespaces.
+	 * Whether this language uses gender-dependent namespace aliases.
+	 * See https://www.mediawiki.org/wiki/Manual:$wgExtraGenderNamespaces
 	 * @return bool
 	 * @since 1.18
 	 */
@@ -3583,7 +3584,7 @@ class Language {
 	}
 	/**
 	 * Provides an alternative text depending on specified gender.
-	 * Usage {{gender:username|masculine|feminine|neutral}}.
+	 * Usage {{gender:username|masculine|feminine|unknown}}.
 	 * username is optional, in which case the gender of current user is used,
 	 * but only in (some) interface messages; otherwise default gender is used.
 	 *
@@ -3591,9 +3592,9 @@ class Language {
 	 * given, it will be returned unconditionally. These details are implied by
 	 * the caller and cannot be overridden in subclasses.
 	 *
-	 * If more than one form is given, the default is to use the neutral one
-	 * if it is specified, and to use the masculine one otherwise. These
-	 * details can be overridden in subclasses.
+	 * If three forms are given, the default is to use the third (unknown) form.
+	 * If fewer than three forms are given, the default is to use the first (masculine) form.
+	 * These details can be overridden in subclasses.
 	 *
 	 * @param $gender string
 	 * @param $forms array