nl_langinfo.3.patch [plain text]
--- _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