stdlib/FreeBSD/strfmon.3.patch

   1 --- _SB/Libc/stdlib/FreeBSD/strfmon.3   2003-05-20 15:23:25.000000000 -0700
   2 +++ _SB/Libc/stdlib/FreeBSD/strfmon.3.edit      2006-06-28 16:55:53.000000000 -0700
   3 @@ -28,25 +28,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 SYNOPSIS
  14  .In monetary.h
  15  .Ft ssize_t
  16 -.Fn strfmon "char * restrict s" "size_t maxsize" "const char * restrict format" "..."
  17 +.Fo strfmon
  18 +.Fa "char *restrict s"
  19 +.Fa "size_t maxsize"
  20 +.Fa "const char *restrict format"
  21 +.Fa "..."
  22 +.Fc
  23 +.In monetary.h
  24 +.In xlocale.h
  25 +.Ft ssize_t
  26 +.Fo strfmon_l
  27 +.Fa "char *restrict s"
  28 +.Fa "size_t maxsize"
  29 +.Fa "locale_t loc"
  30 +.Fa "const char *restrict format"
  31 +.Fa "..."
  32 +.Fc
  33  .Sh DESCRIPTION
  34  The
  35  .Fn strfmon
  36  function places characters into the array pointed to by
  37 -.Fa s
  38 +.Fa s ,
  39  as controlled by the string pointed to by
  40  .Fa format .
  41  No more than
  42  .Fa maxsize
  43  bytes are placed into the array.
  44  .Pp
  45 +While the
  46 +.Fn strfmon
  47 +function uses the current locale, the
  48 +.Fn strfmon_l
  49 +function may be passed a locale directly. See
  50 +.Xr xlocale 3
  51 +for more information.
  52 +.Pp
  53  The format string is composed of zero or more directives:
  54  ordinary characters (not
  55  .Cm % ) ,
  56 @@ -114,9 +138,9 @@
  57  .El
  58  .El
  59  .Sh RETURN VALUES
  60 -If the total number of resulting bytes including the terminating
  61 +If the total number of resulting bytes, including the terminating
  62  .Dv NULL
  63 -byte is not more than
  64 +byte, is not more than
  65  .Fa maxsize ,
  66  .Fn strfmon
  67  returns the number of bytes placed into the array pointed to by
  68 @@ -142,7 +166,8 @@
  69  Not enough memory for temporary buffers.
  70  .El
  71  .Sh SEE ALSO
  72 -.Xr localeconv 3
  73 +.Xr localeconv 3 ,
  74 +.Xr xlocale 3
  75  .Sh STANDARDS
  76  The
  77  .Fn strfmon