--- org/setlocale.3c	Thu Oct 15 11:56:51 2009
+++ setlocale.3c	Thu Oct 29 10:07:35 2009
@@ -121,7 +121,7 @@
      ____________________________________________________________
       CSI                           Enabled
      ____________________________________________________________
-      Interface Stability           Standard
+      Interface Stability           Committed                                 |
      ____________________________________________________________
       MT-Level                      MT-Safe with exceptions
      ____________________________________________________________
@@ -131,7 +131,7 @@
      isdigit(3C),    libc(3LIB),    localeconv(3C),   mbtowc(3C),
      strcoll(3C),    strftime(3C),    strptime(3C)    strxfrm(3C)
      tolower(3C),    wctomb(3C),    attributes(5),    environ(5),
-     locale(5), standards(5)
+     locale(5), locale_alias(5), standards(5)                                 |
 
 NOTES
      It is unsafe for any thread to  change  locale  (by  calling
@@ -149,6 +149,16 @@
      and LC_TIME=ja (where ja indicates Japanese) will not  work,
      because  Japanese  time  cannot  be  represented  in the "C"
      locale's ASCII codeset.
+                                                                              |
+     If a string pointed by locale argument has a locale name that            |
+     does not yield a usable locale in the current system but it is           |
+     a locale name alias that is accepted and supported, such name is         |
+     internally mapped to a corresponding canonical locale name which is      |
+     then used to locate, load, and return the actual locale defined in       |
+     the current system. If successful, the return value of the function is   |
+     the locale name alias. If there is no actual locale for the canonical    |
+     locale name, obviously, the setlocale() will fail. The accepted          |
+     and supported locale name aliases are shown in locale_alias(5).          |
 
 
 SunOS 5.11          Last change: 19 Sep 2005                    1