strfmon.3: Document strfmon_l(3)

Describe strfmon_l(3).

http://pubs.opengroup.org/onlinepubs/9699919799/functions/strfmon.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

man3/strfmon.3

@@ -23,23 +23,46 @@
 .\"
 .TH STRFMON 3  2015-03-02 "Linux" "Linux Programmer's Manual"
 .SH NAME
-strfmon \- convert monetary value to a string
+strfmon, strfmon_l \- convert monetary value to a string
 .SH SYNOPSIS
+.nf
 .B #include <monetary.h>
 .sp
 .BI "ssize_t strfmon(char *" s ", size_t " max ", const char *" format ,
 .B "...);"
+
+.BI "ssize_t strfmon_l(char *" s ", size_t " max ", locale_t " locale ", 
+.B const char *" format , "...);"
+.fi
 .SH DESCRIPTION
 The
 .BR strfmon ()
-function formats the specified amounts
+function formats the specified monetary amount
-according to the format specification
+according to the current locale
+and format specification
 .I format
 and places the
 result in the character array
 .I s
 of size
 .IR max .
+
+The
+.BR strfmon_l ()
+function performs the same task,
+but uses
+the locale specified by
+.IR locale .
+The behavior of
+.BR strfmon_l ()
+is undefined if
+.I locale
+is the special locale object
+.BR LC_GLOBAL_LOCALE
+(see
+.BR duplocale (3))
+or is not a valid locale object handle.
+
 .PP
 Ordinary characters in
 .I format
@@ -146,6 +169,9 @@ Interface	Attribute	Value
 T{
 .BR strfmon ()
 T}	Thread safety	MT-Safe locale
+T{
+.BR strfmon_l ()
+T}	Thread safety	MT-Safe
 .TE
 
 .SH CONFORMING TO
@@ -186,6 +212,7 @@ and Portuguese locales yield
 [ **1234$57Esc] [ **1.234$57PTE ]
 .in
 .SH SEE ALSO
+.BR duplocale (3),
 .BR setlocale (3),
 .BR sprintf (3),
 .BR locale (7)

man3/strfmon_l.3

@@ -0,0 +1 @@
+.so man3/strfmon.3