git: 4e1231260731 - stable/13 - strfmon(3): Wording improvements

From: Konstantin Belousov <>
Date: Tue, 31 Jan 2023 00:39:11 UTC
The branch stable/13 has been updated by kib:


commit 4e1231260731067a5bba2bcbd92cca8b4f78152a
Author:     Jose Luis Duran <>
AuthorDate: 2022-11-08 20:53:17 +0000
Commit:     Konstantin Belousov <>
CommitDate: 2023-01-31 00:38:19 +0000

    strfmon(3): Wording improvements
    (cherry picked from commit 59cc636d94a6c9b28147304fa59351224f801e92)
 lib/libc/stdlib/strfmon.3 | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/lib/libc/stdlib/strfmon.3 b/lib/libc/stdlib/strfmon.3
index 1ddfb77cb0ac..5c110a8987dc 100644
--- a/lib/libc/stdlib/strfmon.3
+++ b/lib/libc/stdlib/strfmon.3
@@ -24,7 +24,7 @@
 .\" $FreeBSD$
-.Dd October 28, 2022
+.Dd January 25, 2023
@@ -37,13 +37,15 @@
 .In monetary.h
 .Ft ssize_t
 .Fn strfmon "char * restrict s" "size_t maxsize" "const char * restrict format" "..."
+.In monetary.h
+.In xlocale.h
 .Ft ssize_t
 .Fn strfmon_l "char * restrict s" "size_t maxsize" "locale_t loc" "const char * restrict format" "..."
 .Fn strfmon
 function places characters into the array pointed to by
-.Fa s
+.Fa s ,
 as controlled by the string pointed to by
 .Fa format .
 No more than
@@ -52,9 +54,9 @@ bytes are placed into the array.
 .Fn strfmon_l
-function does the same as
+function takes an explicit locale argument, whereas the
 .Fn strfmon
-but takes an explicit locale rather than using the current locale.
+function uses the current global or per-thread locale.
 The format string is composed of zero or more directives:
 ordinary characters (not
@@ -129,12 +131,14 @@ character is written.
-If the total number of resulting bytes including the terminating
+If the total number of resulting bytes, including the terminating
 .Dv NUL
-byte is not more than
+byte, is not more than
 .Fa maxsize ,
 .Fn strfmon
-returns the number of bytes placed into the array pointed to by
+.Fn strfmon_l
+return the number of bytes placed into the array pointed to by
 .Fa s ,
 not including the terminating
 .Dv NUL
@@ -144,11 +148,6 @@ the contents of the array are indeterminate,
 .Va errno
 is set to indicate the error.
-.Fn strfmon_l
-function returns the same values as
-.Fn strfmon .
 The following example will format the value
 .Dq Li 1234567.89