locale/FreeBSD/wcsftime.3.patch

   1 --- _SB/Libc/locale/FreeBSD/wcsftime.3  2003-05-20 15:21:44.000000000 -0700
   2 +++ _SB/Libc/locale/FreeBSD/wcsftime.3.edit     2006-06-28 16:55:51.000000000 -0700
   3 @@ -28,7 +28,8 @@
   4  .Dt WCSFTIME 3
   5  .Os
   6  .Sh NAME
   7 -.Nm wcsftime
   8 +.Nm wcsftime ,
   9 +.Nm wcsftime_l
  10  .Nd "convert date and time to a wide-character string"
  11  .Sh LIBRARY
  12  .Lb libc
  13 @@ -36,29 +37,50 @@
  14  .In wchar.h
  15  .Ft size_t
  16  .Fo wcsftime
  17 -.Fa "wchar_t * restrict wcs" "size_t maxsize"
  18 -.Fa "const wchar_t * restrict format" "const struct tm * restrict timeptr"
  19 +.Fa "wchar_t *restrict wcs"
  20 +.Fa "size_t maxsize"
  21 +.Fa "const wchar_t *restrict format"
  22 +.Fa "const struct tm *restrict timeptr"
  23 +.Fc
  24 +.In wchar.h
  25 +.In xlocale.h
  26 +.Ft size_t
  27 +.Fo wcsftime_l
  28 +.Fa "wchar_t *restrict wcs"
  29 +.Fa "size_t maxsize"
  30 +.Fa "const wchar_t *restrict format"
  31 +.Fa "const struct tm *restrict timeptr"
  32 +.Fa "locale_t loc"
  33  .Fc
  34  .Sh DESCRIPTION
  35  The
  36  .Fn wcsftime
  37  function is equivalent to the
  38  .Fn strftime
  39 -function except for the types of its arguments.
  40 +function, except for the types of its arguments.
  41  Refer to
  42  .Xr strftime 3
  43  for a detailed description.
  44 +.Pp
  45 +While the
  46 +.Fn wcsftime
  47 +function uses the current locale, the
  48 +.Fn wcsftime_l
  49 +function may be passed a locale directly. See
  50 +.Xr xlocale 3
  51 +for more information.
  52  .Sh COMPATIBILITY
  53  Some early implementations of
  54  .Fn wcsftime
  55  had a
  56  .Fa format
  57  argument with type
  58 -.Vt "const char *"
  59 +.Vt "const char *" ,
  60  instead of
  61  .Vt "const wchar_t *" .
  62  .Sh SEE ALSO
  63 -.Xr strftime 3
  64 +.Xr strftime 3 ,
  65 +.Xr xlocale 3
  66  .Sh STANDARDS
  67  The
  68  .Fn wcsftime