ICU-9628 Make comments regarding the meaning of gender styles more concise.

X-SVN-Rev: 33095

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/util/GenderInfo.java b/icu4j/main/classes/core/src/com/ibm/icu/util/GenderInfo.java
index 757cc51aea025bf4af66fd93008d133bdea231c2..d2de55cc1ece00c9c5a3e45e08babc542e4ade9f 100644 (file)
--- a/icu4j/main/classes/core/src/com/ibm/icu/util/GenderInfo.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/util/GenderInfo.java
@@ -1,6 +1,6 @@
 /*
  *******************************************************************************
- * Copyright (C) 2003-2012, Google, International Business Machines Corporation and    *
+ * Copyright (C) 2003-2013, Google, International Business Machines Corporation and    *
  * others. All Rights Reserved.                                                *
  *******************************************************************************
 */
@@ -58,17 +58,23 @@ public class GenderInfo {
      */
     public enum ListGenderStyle {
         /**
-         * Always OTHER (if more than one).
+         * For an empty list, returns OTHER;
+         * For a single item, returns its gender;
+         * Otherwise always OTHER.
          */
         NEUTRAL,
         /**
-         * gender(all male) = male, gender(all female) = female, otherwise gender(list) = other.
-         * In particular, any 'other' value makes the overall gender be 'other'.
+         * For an empty list, returns OTHER;
+         * For a single item, returns its gender;
+         * Otherwise gender(all male) = male, gender(all female) = female, otherwise gender(list) = other.
+         * So any 'other' value makes the overall gender be 'other'.
          */
         MIXED_NEUTRAL,
         /**
-         * If more than one, gender(all female) = female, otherwise gender(list) = male.
-         * If more than one, any 'other' value makes the overall gender be 'male'.
+         * For an empty list, returns OTHER;
+         * For a single item, returns its gender;
+         * Otherwise, gender(all female) = female, otherwise gender(list) = male.
+         * So for more than one item, any 'other' value makes the overall gender be 'male'.
          */
         MALE_TAINTS;