Libc-498.tar.gz

[apple/libc.git] / locale / FreeBSD / nl_langinfo.3.patch

--- _SB/Libc/locale/FreeBSD/nl_langinfo.3	2004-11-25 11:38:19.000000000 -0800
+++ _SB/Libc/locale/FreeBSD/nl_langinfo.3.edit	2006-06-28 16:55:51.000000000 -0700
@@ -28,14 +28,24 @@
 .Dt NL_LANGINFO 3
 .Os
 .Sh NAME
-.Nm nl_langinfo
+.Nm nl_langinfo ,
+.Nm nl_langinfo_l
 .Nd language information
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In langinfo.h
 .Ft char *
-.Fn nl_langinfo "nl_item item"
+.Fo nl_langinfo
+.Fa "nl_item item"
+.Fc
+.In langinfo.h
+.In xlocale.h
+.Ft char *
+.Fo nl_langinfo_l
+.Fa "nl_item item"
+.Fa "locale_t loc"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn nl_langinfo
@@ -53,7 +63,7 @@
 or to the
 category
 .Dv LC_ALL ,
-may overwrite buffer pointed by the return value.
+may overwrite the buffer pointed to by the return value.
 .Sh EXAMPLES
 For example:
 .Pp
@@ -65,6 +75,14 @@
 Portuguese, and
 .Qq Li Sun
 if the identified language was English.
+.Pp
+While the
+.Fn nl_langinfo
+function uses the current locale, the
+.Fn nl_langinfo_l
+function may be passed a locale directly. See
+.Xr xlocale 3
+for more information.
 .Sh RETURN VALUES
 In a locale where langinfo data is not defined,
 .Fn nl_langinfo
@@ -77,7 +95,8 @@
 .Fa item
 contains an invalid setting.
 .Sh SEE ALSO
-.Xr setlocale 3
+.Xr setlocale 3 ,
+.Xr xlocale 3
 .Sh STANDARDS
 The
 .Fn nl_langinfo