Libc-1082.50.1.tar.gz

[apple/libc.git] / locale / FreeBSD / wcsftime.3

diff --git a/locale/FreeBSD/wcsftime.3 b/locale/FreeBSD/wcsftime.3
index 5f29f39c7130ef3315a7bd73313ca945b03d147a..b11967a2f4d2ec9d28f9facd60b327315d3016ac 100644 (file)
--- a/locale/FreeBSD/wcsftime.3
+++ b/locale/FreeBSD/wcsftime.3
@@ -28,7 +28,8 @@
 .Dt WCSFTIME 3
 .Os
 .Sh NAME
 .Dt WCSFTIME 3
 .Os
 .Sh NAME

-.Nm wcsftime
+.Nm wcsftime ,
+.Nm wcsftime_l

 .Nd "convert date and time to a wide-character string"
 .Sh LIBRARY
 .Lb libc
 .Nd "convert date and time to a wide-character string"
 .Sh LIBRARY
 .Lb libc


@@ -36,29 +37,50 @@
 .In wchar.h
 .Ft size_t
 .Fo wcsftime
 .In wchar.h
 .Ft size_t
 .Fo wcsftime

-.Fa "wchar_t * restrict wcs" "size_t maxsize"
-.Fa "const wchar_t * restrict format" "const struct tm * restrict timeptr"
+.Fa "wchar_t *restrict wcs"
+.Fa "size_t maxsize"
+.Fa "const wchar_t *restrict format"
+.Fa "const struct tm *restrict timeptr"
+.Fc
+.In wchar.h
+.In xlocale.h
+.Ft size_t
+.Fo wcsftime_l
+.Fa "wchar_t *restrict wcs"
+.Fa "size_t maxsize"
+.Fa "const wchar_t *restrict format"
+.Fa "const struct tm *restrict timeptr"
+.Fa "locale_t loc"

 .Fc
 .Sh DESCRIPTION
 The
 .Fn wcsftime
 function is equivalent to the
 .Fn strftime
 .Fc
 .Sh DESCRIPTION
 The
 .Fn wcsftime
 function is equivalent to the
 .Fn strftime

-function except for the types of its arguments.
+function, except for the types of its arguments.

 Refer to
 .Xr strftime 3
 for a detailed description.
 Refer to
 .Xr strftime 3
 for a detailed description.

+.Pp
+While the
+.Fn wcsftime
+function uses the current locale, the
+.Fn wcsftime_l
+function may be passed a locale directly. See
+.Xr xlocale 3
+for more information.

 .Sh COMPATIBILITY
 Some early implementations of
 .Fn wcsftime
 had a
 .Fa format
 argument with type
 .Sh COMPATIBILITY
 Some early implementations of
 .Fn wcsftime
 had a
 .Fa format
 argument with type

-.Vt "const char *"
+.Vt "const char *" ,

 instead of
 .Vt "const wchar_t *" .
 .Sh SEE ALSO
 instead of
 .Vt "const wchar_t *" .
 .Sh SEE ALSO

-.Xr strftime 3
+.Xr strftime 3 ,
+.Xr xlocale 3

 .Sh STANDARDS
 The
 .Fn wcsftime
 .Sh STANDARDS
 The
 .Fn wcsftime