stdio/FreeBSD/wprintf.3.patch

   1 --- wprintf.3.bsdnew    2009-11-11 13:33:22.000000000 -0800
   2 +++ wprintf.3   2009-11-11 13:33:22.000000000 -0800
   3 @@ -37,8 +37,12 @@
   4  .Dt WPRINTF 3
   5  .Os
   6  .Sh NAME
   7 -.Nm wprintf , fwprintf , swprintf ,
   8 -.Nm vwprintf , vfwprintf , vswprintf
   9 +.Nm fwprintf ,
  10 +.Nm swprintf ,
  11 +.Nm vfwprintf ,
  12 +.Nm vswprintf ,
  13 +.Nm vwprintf ,
  14 +.Nm wprintf
  15  .Nd formatted wide character output conversion
  16  .Sh LIBRARY
  17  .Lb libc
  18 @@ -46,23 +50,49 @@
  19  .In stdio.h
  20  .In wchar.h
  21  .Ft int
  22 -.Fn fwprintf "FILE * restrict stream" "const wchar_t * restrict format" ...
  23 +.Fo fwprintf
  24 +.Fa "FILE *restrict stream"
  25 +.Fa "const wchar_t *restrict format"
  26 +.Fa ...
  27 +.Fc
  28  .Ft int
  29 -.Fn swprintf "wchar_t * restrict ws" "size_t n" "const wchar_t * restrict format" ...
  30 +.Fo swprintf
  31 +.Fa "wchar_t *restrict ws"
  32 +.Fa "size_t n"
  33 +.Fa "const wchar_t *restrict format"
  34 +.Fa ...
  35 +.Fc
  36  .Ft int
  37 -.Fn wprintf "const wchar_t * restrict format" ...
  38 +.Fo wprintf
  39 +.Fa "const wchar_t *restrict format"
  40 +.Fa ...
  41 +.Fc
  42  .In stdarg.h
  43 +.In stdio.h
  44 +.In wchar.h
  45  .Ft int
  46 -.Fn vfwprintf "FILE * restrict stream" "const wchar_t * restrict" "va_list ap"
  47 +.Fo vfwprintf
  48 +.Fa "FILE *restrict stream"
  49 +.Fa "const wchar_t *restrict format"
  50 +.Fa "va_list arg"
  51 +.Fc
  52  .Ft int
  53 -.Fn vswprintf "wchar_t * restrict ws" "size_t n" "const wchar_t *restrict format" "va_list ap"
  54 +.Fo vswprintf
  55 +.Fa "wchar_t *restrict ws"
  56 +.Fa "size_t n"
  57 +.Fa "const wchar_t *restrict format"
  58 +.Fa "va_list arg"
  59 +.Fc
  60  .Ft int
  61 -.Fn vwprintf "const wchar_t * restrict format" "va_list ap"
  62 +.Fo vwprintf
  63 +.Fa "const wchar_t *restrict format"
  64 +.Fa "va_list arg"
  65 +.Fc
  66  .Sh DESCRIPTION
  67  The
  68  .Fn wprintf
  69  family of functions produces output according to a
  70 -.Fa format
  71 +.Fa format ,
  72  as described below.
  73  The
  74  .Fn wprintf
  75 @@ -83,6 +113,12 @@ and
  76  write to the wide character string
  77  .Fa ws .
  78  .Pp
  79 +Extended locale versions of these functions are documented in
  80 +.Xr wprintf_l 3 .
  81 +See
  82 +.Xr xlocale 3
  83 +for more information.
  84 +.Pp
  85  These functions write the output under the control of a
  86  .Fa format
  87  string that specifies how subsequent arguments
  88 @@ -92,7 +128,7 @@ are converted for output.
  89  .Pp
  90  These functions return the number of characters printed
  91  (not including the trailing
  92 -.Ql \e0
  93 +.Ql \e0 ,
  94  used to end output to strings).
  95  .Pp
  96  The
  97 @@ -598,6 +634,7 @@ Refer to
  98  .Xr putwc 3 ,
  99  .Xr setlocale 3 ,
 100  .Xr wcsrtombs 3 ,
 101 +.Xr wprintf_l 3 ,
 102  .Xr wscanf 3
 103  .Sh STANDARDS
 104  Subject to the caveats noted in the
 105 @@ -610,7 +647,7 @@ the
 106  .Fn fwprintf ,
 107  .Fn swprintf ,
 108  .Fn vwprintf ,
 109 -.Fn vfwprintf
 110 +.Fn vfwprintf ,
 111  and
 112  .Fn vswprintf
 113  functions