svn commit: r363289 - stable/12/lib/libc/locale

[Joerg Wunsch]

Author: joerg
Date: Fri Jul 17 22:04:58 2020
New Revision: 363289
URL: https://svnweb.freebsd.org/changeset/base/363289

Log:
  MFC r362708
  
  Explain how to learn about possible recognized locale names

Modified:
  stable/12/lib/libc/locale/setlocale.3
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/lib/libc/locale/setlocale.3
==============================================================================
--- stable/12/lib/libc/locale/setlocale.3	Fri Jul 17 21:55:24 2020	(r363288)
+++ stable/12/lib/libc/locale/setlocale.3	Fri Jul 17 22:04:58 2020	(r363289)
@@ -115,9 +115,24 @@ argument of
 causes
 .Fn setlocale
 to return the current locale.
+.Pp
+The option
+.Fl a
+to the
+.Xr locale 1
+command can be used to display all further possible names for the
+.Fa locale
+argument that are recognized.
+Specifying any unrecognized value for
+.Fa locale
+makes
+.Fn setlocale
+fail.
+.Pp
 By default, C programs start in the
 .Li \&"C"
 locale.
+.Pp
 The only function in the library that sets the locale is
 .Fn setlocale ;
 the locale is never changed as a side effect of some other routine.
@@ -150,6 +165,7 @@ and the category
 .Sh ERRORS
 No errors are defined.
 .Sh SEE ALSO
+.Xr locale 1 ,
 .Xr localedef 1 ,
 .Xr catopen 3 ,
 .Xr ctype 3 ,