stdlib/NetBSD/strfmon.3.patch

   1 --- strfmon.3.orig      2008-04-05 20:02:08.000000000 -0700
   2 +++ strfmon.3   2008-04-05 20:05:49.000000000 -0700
   3 @@ -30,25 +30,49 @@
   4  .Dt STRFMON 3
   5  .Os
   6  .Sh NAME
   7 -.Nm strfmon
   8 +.Nm strfmon ,
   9 +.Nm strfmon_l
  10  .Nd convert monetary value to string
  11 -.Sh LIBRARY
  12 -.Lb libc
  13 +.\" .Sh LIBRARY
  14 +.\" .Lb libc
  15  .Sh SYNOPSIS
  16  .In monetary.h
  17  .Ft ssize_t
  18 -.Fn strfmon "char * restrict s" "size_t maxsize" "const char * restrict format" "..."
  19 +.Fo strfmon
  20 +.Fa "char *restrict s"
  21 +.Fa "size_t maxsize"
  22 +.Fa "const char *restrict format"
  23 +.Fa "..."
  24 +.Fc
  25 +.In monetary.h
  26 +.In xlocale.h
  27 +.Ft ssize_t
  28 +.Fo strfmon_l
  29 +.Fa "char *restrict s"
  30 +.Fa "size_t maxsize"
  31 +.Fa "locale_t loc"
  32 +.Fa "const char *restrict format"
  33 +.Fa "..."
  34 +.Fc
  35  .Sh DESCRIPTION
  36  The
  37  .Fn strfmon
  38  function places characters into the array pointed to by
  39 -.Fa s
  40 +.Fa s ,
  41  as controlled by the string pointed to by
  42  .Fa format .
  43  No more than
  44  .Fa maxsize
  45  bytes are placed into the array.
  46  .Pp
  47 +While the
  48 +.Fn strfmon
  49 +function uses the current locale, the
  50 +.Fn strfmon_l
  51 +function may be passed a locale directly. See
  52 +.Xr xlocale 3
  53 +for more information.
  54 +.Pp
  55  The format string is composed of zero or more directives:
  56  ordinary characters (not
  57  .Cm % ) ,
  58 @@ -116,9 +140,9 @@
  59  .El
  60  .El
  61  .Sh RETURN VALUES
  62 -If the total number of resulting bytes including the terminating
  63 +If the total number of resulting bytes, including the terminating
  64  .Dv NULL
  65 -byte is not more than
  66 +byte, is not more than
  67  .Fa maxsize ,
  68  .Fn strfmon
  69  returns the number of bytes placed into the array pointed to by
  70 @@ -144,7 +168,8 @@
  71  Not enough memory for temporary buffers.
  72  .El
  73  .Sh SEE ALSO
  74 -.Xr localeconv 3
  75 +.Xr localeconv 3 ,
  76 +.Xr xlocale 3
  77  .Sh STANDARDS
  78  The
  79  .Fn strfmon