Libc-763.11.tar.gz

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

--- wcsftime.3.orig	2009-11-09 15:05:25.000000000 -0800
+++ wcsftime.3	2009-11-09 15:05:26.000000000 -0800
@@ -28,7 +28,8 @@
 .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
@@ -36,29 +37,50 @@
 .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
-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.
+.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
-.Vt "const char *"
+.Vt "const char *" ,
 instead of
 .Vt "const wchar_t *" .
 .Sh SEE ALSO
-.Xr strftime 3
+.Xr strftime 3 ,
+.Xr xlocale 3
 .Sh STANDARDS
 The
 .Fn wcsftime