--- org/gettext.3c	Thu Oct 22 14:05:58 2009
+++ gettext.3c	Tue Oct 27 15:03:22 2009
@@ -67,10 +67,20 @@
      returned if n == 1, otherwise msgid2 is returned.
 
      The  NLSPATH  environment  variable  (see   environ(5))   is
-     searched  first for the location of the  LC_MESSAGES catalo-
-     gue. The setting of the LC_MESSAGES category of the  current
+     searched in its entirety first for the location of the LC_MESSAGES       |
+     catalogue. The setting of the LC_MESSAGES category of the  current       |
      locale  determines  the  locale used by  gettext() and dget-
-     text() for string retrieval. The  category  argument  deter-
+     text() for string retrieval. If NLSPATH contains %L and the current      |
+     value of it is a canonical locale name to an obsoleted Solaris locale    |
+     name as described in locale_alias(5) and there is no message catalog     |
+     for the canonical locale name, for a better backward compatibility,      |
+     gettext() and dgettext() use the obsoleted Solaris locale names in       |
+     place for %L as aliases for the canonical locale name and try to         |
+     locate the desired message catalogue. If that still does not yield       |
+     a message catalogue and the value of %L is an accepted and supported     |
+     locale name alias as described in locale_alias(5), the matching          |
+     canonical locale name is used in place for %L to locate the desired      |
+     message    catalogue.     The    category   argument  deter-             |
      mines  the  locale  used  by  dcgettext(). If NLSPATH is not
      defined and the current  locale  is  "C",  gettext(),  dget-
      text(),  and  dcgettext()  simply  return the message string
@@ -80,14 +90,21 @@
      the message catalogue using the scheme described in the fol-
      lowing paragraph.
 
-     The LANGUAGE environment variable is examined  to  determine
-     the  GNU-compatible message catalogues to be used. The value
+     The LANGUAGE environment variable is examined in its entirety to         |
+     determine the GNU-compatible message catalogues to be used. The value    |
      of LANGUAGE is a list of locale names separated by  a  colon
      (':')  character.   If LANGUAGE is defined, each locale name
      is tried in the specified order and if a GNU-compatible mes-
-     sage  catalogue  is  found,  the  message is returned.  If a
+     sage catalogue is found, it is used to return target strings.            |
+     If no GNU-compatible message catalogue is found for all locales          |
+     specified in the LANGUAGE and if there are accepted and supported        |
+     locale name aliases for any of the locale names in the LANGUAGE,         |
+     as specified in locale_alias(5) and in the same manner as described      |
+     in the NLSPATH description at the above for %L and the current           |
+     locale name, the locale name aliases are used once again to search       |
+     corresponding  GNU-compatible  message  catalogues.     If a             |
      GNU-compatible message catalogue is found but failed to find
-     a  corresponding  msgid,  the  msgid  string  is  return. If
+     a  corresponding  msgid,  the  msgid  string is returned. If             |
      LANGUAGE is not defined or if a Solaris message catalogue is
      found  or  no  GNU-compatible  message catalogue is found in
      processing LANGUAGE, the pathname used to locate the message
@@ -97,7 +114,13 @@
      if gettext(),  dgettext(),  ngettext(),  or  dngettext()  is
      called,  or  LC_XXX where the name is the same as the locale
      category name specified by the category argument  to  dcget-
-     text() or dcngettext().
+     text() or dcngettext(). In this last stage of search of message          |
+     catalogue, if there is no message catalogue found with the locale        |
+     name and if the locale name has aliases as described in                  |
+     locale_alias(5), the locale name aliases are used in place of            |
+     the locale name to locate the message catalogue in the same              |
+     manner as described in the above for the processing of                   |
+     the locale name aliases of the locales defined at the LANGUAGE.          |
 
      For gettext() and ngettext(), the domain used is set by  the
      last  valid  call  to  textdomain().  If  a  valid  call  to
@@ -262,7 +285,8 @@
      ____________________________________________________________
       ATTRIBUTE TYPE                ATTRIBUTE VALUE
      ____________________________________________________________
-      Interface Stability           See below.
+      Interface Stability           Committed                                 |
+		                    See also at below.                        |
      ____________________________________________________________
       MT-Level                      Safe with exceptions
      ____________________________________________________________
@@ -272,7 +296,7 @@
 
 SEE ALSO
      msgfmt(1),  xgettext(1),  iconv_open(3C),  libintl.h(3HEAD),
-     setlocale(3C), attributes(5), environ(5)
+     setlocale(3C), attributes(5), environ(5), locale_alias(5)                |
 
 
 SunOS 5.11           Last change: 4 Jun 2008                    1